claude-flow-novice 2.18.5 → 2.18.6

package/.claude/skills/cfn-error-management/lib/logging/integrate-cli.sh

@@ -0,0 +1,232 @@
+#!/bin/bash
+
+##############################################################################
+# CFN Error Logging - CLI Integration Script
+# Version: 1.0.0
+#
+# Integration script for CLI CFN Loop error logging
+# Automatically triggers error capture on CLI failures
+#
+# Usage: Source this script in CLI commands or orchestrator scripts
+# source /path/to/integrate-cli.sh
+##############################################################################
+
+# CFN Error Logging CLI Integration
+# This script provides helper functions for CLI CFN Loop error logging
+
+# Get the script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ERROR_LOGGING_SCRIPT="$SCRIPT_DIR/invoke-error-logging.sh"
+
+# Helper function
+log() {
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*"
+}
+
+# Ensure error logging script exists
+if [ ! -f "$ERROR_LOGGING_SCRIPT" ]; then
+  echo "⚠️  Warning: CFN error logging script not found at $ERROR_LOGGING_SCRIPT"
+  return 1
+fi
+
+# Function to capture error on CFN Loop failure
+cfn_capture_error() {
+  local task_id="$1"
+  local error_type="${2:-cli}"
+  local error_message="${3:-CFN Loop failed}"
+  local exit_code="${4:-$?}"
+  local context_json="${5:-}"
+
+  # Only capture if we have a task ID
+  if [ -n "$task_id" ]; then
+    "$ERROR_LOGGING_SCRIPT" \
+      --action capture \
+      --task-id "$task_id" \
+      --error-type "$error_type" \
+      --error-message "$error_message" \
+      --exit-code "$exit_code" \
+      --context "$context_json" \
+      >/dev/null 2>&1 || true
+  fi
+}
+
+# Function to generate error report
+cfn_generate_report() {
+  local task_id="$1"
+  local format="${2:-markdown}"
+
+  if [ -n "$task_id" ]; then
+    "$ERROR_LOGGING_SCRIPT" \
+      --action report \
+      --task-id "$task_id" \
+      --format "$format" \
+      2>/dev/null || echo "Failed to generate report for task: $task_id"
+  else
+    echo "❌ Error: Task ID required for report generation"
+    return 1
+  fi
+}
+
+# Function to show available error logs
+cfn_list_errors() {
+  local since="${1:-24h}"
+  local format="${2:-table}"
+
+  "$ERROR_LOGGING_SCRIPT" \
+    --action list \
+    --since "$since" \
+    --format "$format" \
+    2>/dev/null || echo "Failed to list error logs"
+}
+
+# Function to run system diagnostics
+cfn_run_diagnostics() {
+  "$ERROR_LOGGING_SCRIPT" \
+    --action diagnostics \
+    2>/dev/null || echo "Failed to run diagnostics"
+}
+
+# Function to validate dependencies
+cfn_validate_dependencies() {
+  "$ERROR_LOGGING_SCRIPT" \
+    --action validate \
+    2>/dev/null || echo "Failed to validate dependencies"
+}
+
+# Enhanced CLI command wrapper with error logging
+cfn_cli_wrapper() {
+  local command="$1"
+  local task_id="$2"
+  shift 2
+
+  # Generate task ID if not provided
+  if [ -z "$task_id" ]; then
+    task_id="cfn-cli-$(date +%s%N | tail -c 7)-${RANDOM}"
+  fi
+
+  # Execute the command with error capture
+  if "$command"; then
+    local exit_code=$?
+    log "✅ CLI command succeeded for task: $task_id"
+    return $exit_code
+  else
+    local exit_code=$?
+    log "❌ CLI command failed for task: $task_id (exit code: $exit_code)"
+
+    # Capture error details
+    cfn_capture_error "$task_id" "cli" "CLI command failed: $command" "$exit_code"
+
+    # Generate and show report
+    echo ""
+    echo "📋 Generating error report..."
+    cfn_generate_report "$task_id"
+
+    return $exit_code
+  fi
+}
+
+# Error trap for automatic capture
+# Usage: trap 'cfn_error_trap $TASK_ID "CLI operation failed"' ERR
+cfn_error_trap() {
+  local task_id="$1"
+  local context="${2:-Unknown error occurred}"
+  local exit_code="${3:-$?}"
+
+  log "🚨 CFN Error Trap activated"
+  cfn_capture_error "$task_id" "trap" "$context" "$exit_code"
+
+  # Generate report automatically
+  if [ -n "$task_id" ]; then
+    echo ""
+    echo "📋 Auto-generated error report:"
+    cfn_generate_report "$task_id"
+  fi
+}
+
+# Pre-flight validation with error capture
+cfn_preflight_check() {
+  local task_id="$1"
+
+  log "🔍 Running pre-flight validation for task: $task_id"
+
+  # Validate dependencies
+  if ! cfn_validate_dependencies; then
+    local exit_code=$?
+    cfn_capture_error "$task_id" "preflight" "Pre-flight validation failed" "$exit_code"
+    return $exit_code
+  fi
+
+  # Validate environment
+  local issues=()
+
+  # Check Redis
+  if ! redis-cli ping >/dev/null 2>&1; then
+    issues+=("Redis not connected")
+  fi
+
+  # Check available memory
+  if command -v free >/dev/null 2>&1; then
+    local available_mem=$(free -m 2>/dev/null | awk 'NR==2{print int($7)}' || echo "0")
+    if [ "$available_mem" -lt 512 ]; then
+      issues+=("Low memory (${available_mem}MB available)")
+    fi
+  fi
+
+  # Check disk space
+  if command -v df >/dev/null 2>&1; then
+    local available_space=$(df "$PROJECT_ROOT" 2>/dev/null | awk 'NR==2{print int($4/1024)}' || echo "0")
+    if [ "$available_space" -lt 100 ]; then
+      issues+=("Low disk space (${available_space}MB available)")
+    fi
+  fi
+
+  if [ ${#issues[@]} -gt 0 ]; then
+    log "⚠️  Pre-flight issues detected:"
+    for issue in "${issues[@]}"; do
+      log "  - $issue"
+    done
+
+    # Don't fail on warnings, just capture
+    local context_json="{\"warnings\": [$(printf '"%s",' "${issues[@]}" | sed 's/,$//')],\"severity\": \"warning\"}"
+    cfn_capture_error "$task_id" "preflight-warnings" "Pre-flight validation completed with warnings" "0" "$context_json"
+  else
+    log "✅ Pre-flight validation passed"
+  fi
+}
+
+# Post-error cleanup with error logging
+cfn_post_error_cleanup() {
+  local task_id="$1"
+  local exit_code="${2:-$?}"
+
+  log "🧹 Running post-error cleanup for task: $task_id"
+
+  # Capture final error state
+  cfn_capture_error "$task_id" "cleanup" "Post-error cleanup triggered" "$exit_code"
+
+  # Run cleanup
+  if [ -f "$ERROR_LOGGING_SCRIPT" ]; then
+    "$ERROR_LOGGING_SCRIPT" --action cleanup --retention-days 7 >/dev/null 2>&1 || true
+  fi
+
+  log "✅ Post-error cleanup completed"
+}
+
+# Export functions for use in other scripts
+export -f cfn_capture_error
+export -f cfn_generate_report
+export -f cfn_list_errors
+export -f cfn_run_diagnostics
+export -f cfn_validate_dependencies
+export -f cfn_cli_wrapper
+export -f cfn_error_trap
+export -f cfn_preflight_check
+export -f cfn_post_error_cleanup
+
+# Convenience aliases
+alias cfn-logs='cfn_list_errors'
+alias cfn-report='cfn_generate_report'
+alias cfn-diag='cfn_run_diagnostics'
+alias cfn-check='cfn_validate_dependencies'
+
+log "CFN Error Logging CLI integration loaded"

package/.claude/skills/cfn-error-management/lib/logging/integrate-docker.sh

@@ -0,0 +1,294 @@
+#!/bin/bash
+
+##############################################################################
+# CFN Error Logging - Docker Integration Script
+# Version: 1.0.0
+#
+# Integration script for Docker CFN Loop error logging
+# Automatically triggers error capture on Docker container failures
+#
+# Usage: Source this script in Docker commands or orchestrator scripts
+# source /path/to/integrate-docker.sh
+##############################################################################
+
+# CFN Error Logging Docker Integration
+# This script provides helper functions for Docker CFN Loop error logging
+
+# Get the script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ERROR_LOGGING_SCRIPT="$SCRIPT_DIR/invoke-error-logging.sh"
+
+# Helper function
+log() {
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*"
+}
+
+# Ensure error logging script exists
+if [ ! -f "$ERROR_LOGGING_SCRIPT" ]; then
+  echo "⚠️  Warning: CFN error logging script not found at $ERROR_LOGGING_SCRIPT"
+  return 1
+fi
+
+# Docker-specific environment detection
+is_docker_environment() {
+  [ -f /.dockerenv ] || [ -n "${DOCKER_CONTAINER:-}" ] || grep -q 'docker\|container' /proc/1/cgroup 2>/dev/null
+}
+
+# Function to capture Docker container error
+cfn_capture_docker_error() {
+  local task_id="$1"
+  local container_name="$2"
+  local error_type="${3:-docker}"
+  local error_message="${4:-Docker container failed}"
+  local exit_code="${5:-$?}"
+  local context_json="${6:-}"
+
+  # Add Docker-specific context
+  local docker_context="{"
+  docker_context+=","
+  docker_context+="\"container_name\": \"$container_name\","
+  docker_context+="\"docker_id\": \"${DOCKER_CONTAINER_ID:-unknown}\","
+  docker_context+="\"docker_image\": \"${DOCKER_IMAGE:-unknown}\","
+  docker_context+="\"docker_network\": \"${DOCKER_NETWORK:-unknown}\""
+
+  # Container resource information
+  if command -v docker >/dev/null 2>&1 && [ -n "$container_name" ]; then
+    local container_info=$(docker inspect "$container_name" 2>/dev/null || echo "{}")
+    local memory_usage=$(echo "$container_info" | jq -r '.[0].MemoryUsage // 0' 2>/dev/null || echo "0")
+    local cpu_usage=$(echo "$container_info" | jq -r '.[0].CPUUsage // 0' 2>/dev/null || echo "0")
+
+    docker_context+=","
+    docker_context+="\"memory_usage_mb\": $memory_usage,"
+    docker_context+="\"cpu_usage_percent\": $cpu_usage"
+  fi
+
+  docker_context+="}"
+
+  # Merge with provided context
+  if [ -n "$CONTEXT_JSON" ]; then
+    docker_context="$docker_context,$CONTEXT_JSON"
+  fi
+
+  docker_context+="}"
+
+  # Only capture if we have a task ID
+  if [ -n "$task_id" ]; then
+    "$ERROR_LOGGING_SCRIPT" \
+      --action capture \
+      --task-id "$task_id" \
+      --error-type "$error_type" \
+      --error-message "$error_message" \
+      --exit-code "$exit_code" \
+      --context "$docker_context" \
+      >/dev/null 2>&1 || true
+  fi
+}
+
+# Function to capture Docker logs
+cfn_capture_docker_logs() {
+  local task_id="$1"
+  local container_name="$2"
+  local lines="${3:-100}"
+
+  if [ -n "$container_name" ] && command -v docker >/dev/null 2>&1; then
+    local log_file="$LOG_BASE_DIR/docker-logs-${task_id}-$(date +%s).txt"
+    mkdir -p "$LOG_BASE_DIR"
+
+    log "INFO Capturing Docker logs for container: $container_name"
+
+    docker logs --tail "$lines" "$container_name" 2>" "$log_file" || true
+
+    log "Docker logs captured: $log_file"
+  fi
+}
+
+# Function to capture Docker container state
+cfn_capture_docker_state() {
+  local task_id="$1"
+  local container_name="$2"
+
+  if [ -n "$container_name" ] && command -v docker >/dev/null 2>&1; then
+    local state_file="$LOG_BASE_DIR/docker-state-${task_id}-$(date +%s).json"
+    mkdir -p "$LOG_BASE_DIR"
+
+    log "CAPTURING Capturing Docker container state for: $container_name"
+
+    docker inspect "$container_name" 2> "$state_file" || true
+
+    log "Docker state captured: $state_file"
+  fi
+}
+
+# Enhanced Docker command wrapper with error logging
+cfn_docker_wrapper() {
+  local docker_command="$1"
+  local container_name="$2"
+  local task_id="$3"
+  shift 3
+
+  # Generate task ID if not provided
+  if [ -z "$task_id" ]; then
+    task_id="cfn-docker-$(date +%s%N | tail -c 7)-${RANDOM}"
+  fi
+
+  # Generate container name if not provided
+  if [ -z "$container_name" ]; then
+    container_name="cfn-${task_id}"
+  fi
+
+  log "Starting Docker container: $container_name (task: $task_id)"
+
+  # Execute Docker command with error capture
+  if $docker_command; then
+    local exit_code=$?
+    log "SUCCESS Docker command succeeded for task: $task_id (container: $container_name)"
+    return $exit_code
+  else
+    local exit_code=$?
+    log "ERROR Docker command failed for task: $task_id (container: $container_name, exit code: $exit_code)"
+
+    # Capture comprehensive Docker error information
+    cfn_capture_docker_error "$task_id" "$container_name" "docker" "Docker command failed: $docker_command" "$exit_code"
+    cfn_capture_docker_logs "$task_id" "$container_name"
+    cfn_capture_docker_state "$task_id" "$container_name"
+
+    # Generate and show report
+    echo ""
+    echo "INFO Generating Docker error report..."
+    cfn_generate_report "$task_id"
+
+    return $exit_code
+  fi
+}
+
+# Docker container monitoring
+cfn_monitor_docker_container() {
+  local container_name="$1"
+  local task_id="$2"
+  local duration="${3:-60}"  # Default 60 seconds
+
+  if [ -z "$container_name" ]; then
+    echo "ERROR Error: Container name required for monitoring"
+    return 1
+  fi
+
+  log "WATCHING Monitoring Docker container: $container_name (duration: ${duration}s)"
+
+  local start_time=$(date +%s)
+  local end_time=$((start_time + duration))
+  local current_time
+
+  while [ $current_time -lt $end_time ]; do
+    if command -v docker >/dev/null 2>&1 && docker ps --filter "name=$container_name" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" 2>/dev/null | grep -q "$container_name"; then
+      # Container is running
+      local container_status=$(docker ps --filter "name=$container_name" --format "{{.Status}}" 2>/dev/null)
+      local resource_usage=$(docker stats --no-stream --format "table {{.Container}}\t{{.CPUPerc}}\t{{.MemUsage}}" --filter "name=$container_name" 2>/dev/null | tail -n +2)
+
+      if [ -n "$resource_usage" ]; then
+        log "MONITORING Container $container_name ($container_status): $resource_usage"
+      fi
+    else
+      # Container stopped or failed
+      log "⚠️  Container $container_name is no longer running"
+
+      # Capture final state and error information
+      cfn_capture_docker_error "$task_id" "$container_name" "docker-monitoring" "Container stopped during monitoring"
+      break
+    fi
+
+    sleep 5
+    current_time=$(date +%s)
+  done
+
+  log "WATCHING Docker monitoring completed for: $container_name"
+}
+
+# Docker cleanup with error logging
+cfn_docker_cleanup() {
+  local task_id="$1"
+  local container_pattern="$2"
+
+  log "CLEANING Running Docker cleanup for task: $task_id"
+
+  # Stop and remove containers matching pattern
+  if [ -n "$container_pattern" ]; then
+    local containers=$(docker ps -a --filter "name=$container_pattern" --format "{{.Names}}" 2>/dev/null || echo "")
+
+    for container in $containers; do
+      log "  Stopping container: $container"
+      docker stop "$container" >/dev/null 2>&1 || true
+      docker rm "$container" >/dev/null 2>/dev/null || true
+    done
+  fi
+
+  # Remove Docker networks if they belong to this task
+  local networks=$(docker network ls --filter "name=cfn-$task_id-*" --format "{{.Name}}" 2>/dev/null || echo "")
+
+  for network in $networks; do
+    log "  Removing network: $network"
+    docker network rm "$network" >/dev/null 2>/dev/null || true
+  done
+
+  # Remove Docker volumes if they belong to this task
+  local volumes=$(docker volume ls --filter "name=cfn-$task_id-*" --format "{{.Name}}" 2>/dev/null || echo "")
+
+  for volume in $volumes; do
+    log "  Removing volume: $volume"
+    docker volume rm "$volume" >/dev/null 2/dv/null || true
+  done
+
+  # Capture cleanup state
+  cfn_capture_docker_error "$task_id" "docker-cleanup" "Docker cleanup completed" "0"
+
+  # Run standard cleanup
+  if [ -f "$ERROR_LOGGING_SCRIPT" ]; then
+    "$ERROR_LOGGING_SCRIPT" --action cleanup --retention-days 7 >/dev/null 2>&1 || true
+  fi
+
+  log "SUCCESS Docker cleanup completed"
+}
+
+# Docker resource monitoring
+cfn_monitor_docker_resources() {
+  local task_id="$1"
+
+  log "MONITORING Monitoring Docker resources for task: $task_id"
+
+  if command -v docker >/dev/null 2>&1; then
+    echo "Docker System Status:"
+    docker system df
+    echo ""
+
+    echo "Running Containers:"
+    docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}\t{{.Ports}}\t{{.Size}}"
+    echo ""
+
+    echo "Resource Usage:"
+    docker stats --no-stream --format "table {{.Container}}\t{{.CPUPerc}}\{{.MemUsage}}\t{{.NetIO}}" | head -10
+    echo ""
+
+    # CFN-specific containers
+    echo "CFN Loop Containers:"
+    docker ps --filter "name=cfn-*" --format "table {{.Names}}\t{{.Image}}\t{{.Status}}\t{{.CreatedAt}}" 2>/dev/null || echo "No CFN containers running"
+  fi
+}
+
+# Export functions for use in other scripts
+export -f cfn_capture_docker_error
+export -f cfn_capture_docker_logs
+export -f cfn_capture_docker_state
+export -f cfn_docker_wrapper
+export -f cfn_monitor_docker_container
+export -f cfn_docker_cleanup
+export -f cfn_monitor_docker_resources
+
+# Convenience aliases
+if is_docker_environment; then
+  alias cfn-docker-logs='cfn_capture_docker_logs'
+  alias cfn-docker-state='cfn_capture_docker_state'
+  alias cfn-docker-monitor='cfn_monitor_docker_container'
+  alias cfn-docker-cleanup='cfn_docker_cleanup'
+  alias cfn-docker-resources='cfn_monitor_docker_resources'
+fi
+
+log "CFN Error Logging Docker integration loaded"