claude-flow-novice 2.18.5 → 2.18.6

package/.claude/skills/cfn-agent-lifecycle/lib/audit/execute-lifecycle-hook.sh

@@ -0,0 +1,544 @@
+#!/bin/bash
+
+# Agent Lifecycle Hook Execution Script
+# Provides SQLite-based lifecycle management for agent auditing
+# Usage: ./execute-lifecycle-hook.sh <action> [options]
+
+set -euo pipefail
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DB_PATH="${AGENT_LIFECYCLE_DB:-${SCRIPT_DIR}/../../../../../data/agent-lifecycle.db}"
+
+# Source parameterized query library for SQL injection prevention
+source "${SCRIPT_DIR}/../bootstrap/sqlite-params.sh"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Logging functions
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+# Initialize SQLite database
+init_database() {
+    if [[ ! -f "$DB_PATH" ]]; then
+        log_info "Creating agent lifecycle database: $DB_PATH"
+        sqlite3 "$DB_PATH" << 'EOF'
+-- Create agents table
+CREATE TABLE IF NOT EXISTS agents (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    type TEXT NOT NULL,
+    status TEXT NOT NULL DEFAULT 'spawned',
+    confidence REAL,
+    output TEXT,
+    metadata TEXT,
+    spawned_at TEXT NOT NULL,
+    completed_at TEXT,
+    updated_at TEXT NOT NULL
+);
+
+-- Create lifecycle_events table
+CREATE TABLE IF NOT EXISTS lifecycle_events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    agent_id TEXT NOT NULL,
+    event_type TEXT NOT NULL,
+    confidence REAL,
+    reasoning TEXT,
+    phase TEXT,
+    iteration INTEGER,
+    timestamp TEXT NOT NULL,
+    FOREIGN KEY (agent_id) REFERENCES agents(id)
+);
+
+-- Create indexes for performance
+CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
+CREATE INDEX IF NOT EXISTS idx_agents_type ON agents(type);
+CREATE INDEX IF NOT EXISTS idx_lifecycle_agent_id ON lifecycle_events(agent_id);
+CREATE INDEX IF NOT EXISTS idx_lifecycle_timestamp ON lifecycle_events(timestamp);
+CREATE INDEX IF NOT EXISTS idx_lifecycle_event_type ON lifecycle_events(event_type);
+EOF
+        log_success "Database initialized successfully"
+    fi
+}
+
+# Validate agent ID format
+validate_agent_id() {
+    local agent_id="$1"
+    if [[ ! "$agent_id" =~ ^[a-zA-Z0-9_-]+$ ]]; then
+        log_error "Invalid agent ID format: $agent_id"
+        log_error "Agent ID must contain only alphanumeric characters, hyphens, and underscores"
+        exit 1
+    fi
+
+    if [[ ${#agent_id} -lt 3 || ${#agent_id} -gt 64 ]]; then
+        log_error "Agent ID must be between 3 and 64 characters: $agent_id"
+        exit 1
+    fi
+}
+
+# Validate confidence score
+validate_confidence() {
+    local confidence="$1"
+    if [[ ! "$confidence" =~ ^0\.[0-9]+$|^1\.0$|^0$|^1$ ]]; then
+        log_error "Invalid confidence score: $confidence"
+        log_error "Confidence must be between 0.0 and 1.0"
+        exit 1
+    fi
+}
+
+# Spawn agent registration
+spawn_agent() {
+    local agent_id="$1"
+    local agent_type="$2"
+    local acl_level="${3:-1}"
+    local agent_name="${4:-$agent_id}"
+
+    validate_agent_id "$agent_id"
+
+    if [[ ! "$acl_level" =~ ^[1-6]$ ]]; then
+        log_error "Invalid ACL level: $acl_level (must be 1-6)"
+        exit 1
+    fi
+
+    log_info "Registering agent spawn: $agent_id (type: $agent_type, ACL: $acl_level)"
+
+    # Use parameterized query for agent insertion
+    local spawn_timestamp
+    spawn_timestamp="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+    local metadata_json="{\"aclLevel\": $acl_level, \"spawnedAt\": \"$spawn_timestamp\"}"
+
+    sqlite_upsert "$DB_PATH" \
+        "INSERT OR REPLACE INTO agents (id, name, type, status, metadata, spawned_at, updated_at) VALUES (?1, ?2, ?3, 'spawned', ?4, datetime('now'), datetime('now'))" \
+        "$agent_id" "$agent_name" "$agent_type" "$metadata_json"
+
+    # Log spawn event (parameterized query)
+    sqlite_insert "$DB_PATH" \
+        "INSERT INTO lifecycle_events (agent_id, event_type, reasoning, timestamp) VALUES (?1, 'spawn', 'Agent spawned via lifecycle hook', datetime('now'))" \
+        "$agent_id"
+
+    log_success "Agent $agent_id registered successfully"
+}
+
+# Update agent confidence
+update_confidence() {
+    local agent_id="$1"
+    local confidence="$2"
+    local reasoning="${3:-No reasoning provided}"
+    local phase="${4:-}"
+    local iteration="${5:-}"
+
+    validate_agent_id "$agent_id"
+    validate_confidence "$confidence"
+
+    log_info "Updating confidence for agent $agent_id: $confidence"
+
+    # Update agent confidence (parameterized query)
+    sqlite_update "$DB_PATH" \
+        "UPDATE agents SET confidence = ?1, updated_at = datetime('now') WHERE id = ?2" \
+        "$confidence" "$agent_id"
+
+    # Log confidence update event (parameterized query with optional fields)
+    if [[ -n "$phase" && -n "$iteration" ]]; then
+        sqlite_insert "$DB_PATH" \
+            "INSERT INTO lifecycle_events (agent_id, event_type, confidence, reasoning, phase, iteration, timestamp) VALUES (?1, 'confidence_update', ?2, ?3, ?4, ?5, datetime('now'))" \
+            "$agent_id" "$confidence" "$reasoning" "$phase" "$iteration"
+    elif [[ -n "$phase" ]]; then
+        sqlite_insert "$DB_PATH" \
+            "INSERT INTO lifecycle_events (agent_id, event_type, confidence, reasoning, phase, timestamp) VALUES (?1, 'confidence_update', ?2, ?3, ?4, datetime('now'))" \
+            "$agent_id" "$confidence" "$reasoning" "$phase"
+    elif [[ -n "$iteration" ]]; then
+        sqlite_insert "$DB_PATH" \
+            "INSERT INTO lifecycle_events (agent_id, event_type, confidence, reasoning, iteration, timestamp) VALUES (?1, 'confidence_update', ?2, ?3, ?4, datetime('now'))" \
+            "$agent_id" "$confidence" "$reasoning" "$iteration"
+    else
+        sqlite_insert "$DB_PATH" \
+            "INSERT INTO lifecycle_events (agent_id, event_type, confidence, reasoning, timestamp) VALUES (?1, 'confidence_update', ?2, ?3, datetime('now'))" \
+            "$agent_id" "$confidence" "$reasoning"
+    fi
+
+    log_success "Confidence updated for agent $agent_id"
+}
+
+# Complete agent
+complete_agent() {
+    local agent_id="$1"
+    local confidence="$2"
+    local output="${3:-}"
+    local phase="${4:-}"
+    local iteration="${5:-}"
+
+    validate_agent_id "$agent_id"
+    validate_confidence "$confidence"
+
+    log_info "Completing agent $agent_id with confidence: $confidence"
+
+    # Mark agent as completed (parameterized query)
+    if [[ -n "$output" ]]; then
+        sqlite_update "$DB_PATH" \
+            "UPDATE agents SET status = 'completed', confidence = ?1, output = ?2, completed_at = datetime('now'), updated_at = datetime('now') WHERE id = ?3" \
+            "$confidence" "$output" "$agent_id"
+    else
+        sqlite_update "$DB_PATH" \
+            "UPDATE agents SET status = 'completed', confidence = ?1, completed_at = datetime('now'), updated_at = datetime('now') WHERE id = ?2" \
+            "$confidence" "$agent_id"
+    fi
+
+    # Log completion event (parameterized query with optional fields)
+    local reasoning="${output:-Agent completed}"
+    if [[ -n "$phase" && -n "$iteration" ]]; then
+        sqlite_insert "$DB_PATH" \
+            "INSERT INTO lifecycle_events (agent_id, event_type, confidence, reasoning, phase, iteration, timestamp) VALUES (?1, 'complete', ?2, ?3, ?4, ?5, datetime('now'))" \
+            "$agent_id" "$confidence" "$reasoning" "$phase" "$iteration"
+    elif [[ -n "$phase" ]]; then
+        sqlite_insert "$DB_PATH" \
+            "INSERT INTO lifecycle_events (agent_id, event_type, confidence, reasoning, phase, timestamp) VALUES (?1, 'complete', ?2, ?3, ?4, datetime('now'))" \
+            "$agent_id" "$confidence" "$reasoning" "$phase"
+    elif [[ -n "$iteration" ]]; then
+        sqlite_insert "$DB_PATH" \
+            "INSERT INTO lifecycle_events (agent_id, event_type, confidence, reasoning, iteration, timestamp) VALUES (?1, 'complete', ?2, ?3, ?4, datetime('now'))" \
+            "$agent_id" "$confidence" "$reasoning" "$iteration"
+    else
+        sqlite_insert "$DB_PATH" \
+            "INSERT INTO lifecycle_events (agent_id, event_type, confidence, reasoning, timestamp) VALUES (?1, 'complete', ?2, ?3, datetime('now'))" \
+            "$agent_id" "$confidence" "$reasoning"
+    fi
+
+    # Check CFN Loop gate
+    local gate_status="FAIL"
+    if (( $(echo "$confidence >= 0.75" | bc -l) )); then
+        gate_status="PASS"
+    fi
+
+    log_success "Agent $agent_id completed (CFN Loop 3 Gate: $gate_status)"
+}
+
+# Terminate agent
+terminate_agent() {
+    local agent_id="$1"
+    local reason="${2:-Normal termination}"
+
+    validate_agent_id "$agent_id"
+
+    log_info "Terminating agent $agent_id: $reason"
+
+    # Mark agent as terminated (parameterized query)
+    sqlite_update "$DB_PATH" \
+        "UPDATE agents SET status = 'terminated', updated_at = datetime('now') WHERE id = ?1" \
+        "$agent_id"
+
+    # Log termination event (parameterized query)
+    sqlite_insert "$DB_PATH" \
+        "INSERT INTO lifecycle_events (agent_id, event_type, reasoning, timestamp) VALUES (?1, 'terminate', ?2, datetime('now'))" \
+        "$agent_id" "$reason"
+
+    log_success "Agent $agent_id terminated"
+}
+
+# Query agent status
+query_status() {
+    local agent_id="$1"
+    local limit="${2:-10}"
+
+    validate_agent_id "$agent_id"
+
+    log_info "Querying status for agent $agent_id"
+
+    echo ""
+    echo "=== Agent Status ==="
+    sqlite_select "$DB_PATH" \
+        "SELECT id, name, type, status, confidence, spawned_at, completed_at, updated_at FROM agents WHERE id = ?1" \
+        "$agent_id"
+
+    echo ""
+    echo "=== Recent Lifecycle Events ==="
+    sqlite_select "$DB_PATH" \
+        "SELECT timestamp, event_type, confidence, reasoning FROM lifecycle_events WHERE agent_id = ?1 ORDER BY timestamp DESC LIMIT ?2" \
+        "$agent_id" "$limit"
+}
+
+# Show usage
+show_usage() {
+    echo "Agent Lifecycle Hook Execution Script"
+    echo ""
+    echo "Usage: $0 <action> [options]"
+    echo ""
+    echo "Actions:"
+    echo "  spawn     --agent-id <id> --agent-type <type> [--acl-level <level>] [--name <name>]"
+    echo "  update    --agent-id <id> --confidence <score> --reasoning <text> [--phase <phase>] [--iteration <n>]"
+    echo "  complete  --agent-id <id> --confidence <score> [--output <text>] [--phase <phase>] [--iteration <n>]"
+    echo "  terminate --agent-id <id> [--reason <text>]"
+    echo "  status    --agent-id <id> [--limit <n>]"
+    echo ""
+    echo "Environment Variables:"
+    echo "  AGENT_LIFECYCLE_DB    Path to SQLite database (default: ./agent-lifecycle.db)"
+    echo ""
+    echo "Examples:"
+    echo "  $0 spawn --agent-id docker-1 --agent-type docker-specialist --acl-level 1"
+    echo "  $0 update --agent-id docker-1 --confidence 0.85 --reasoning \"Implementation complete\""
+    echo "  $0 complete --agent-id docker-1 --confidence 0.90 --output \"Docker setup complete\""
+    echo "  $0 status --agent-id docker-1"
+}
+
+# Parse command line arguments
+parse_args() {
+    local action="$1"
+    shift
+
+    case "$action" in
+        "spawn")
+            local agent_id=""
+            local agent_type=""
+            local acl_level="1"
+            local agent_name=""
+
+            while [[ $# -gt 0 ]]; do
+                case "$1" in
+                    --agent-id)
+                        agent_id="$2"
+                        shift 2
+                        ;;
+                    --agent-type)
+                        agent_type="$2"
+                        shift 2
+                        ;;
+                    --acl-level)
+                        acl_level="$2"
+                        shift 2
+                        ;;
+                    --name)
+                        agent_name="$2"
+                        shift 2
+                        ;;
+                    *)
+                        log_error "Unknown option: $1"
+                        show_usage
+                        exit 1
+                        ;;
+                esac
+            done
+
+            if [[ -z "$agent_id" || -z "$agent_type" ]]; then
+                log_error "Missing required arguments for spawn"
+                show_usage
+                exit 1
+            fi
+
+            init_database
+            spawn_agent "$agent_id" "$agent_type" "$acl_level" "$agent_name"
+            ;;
+
+        "update")
+            local agent_id=""
+            local confidence=""
+            local reasoning=""
+            local phase=""
+            local iteration=""
+
+            while [[ $# -gt 0 ]]; do
+                case "$1" in
+                    --agent-id)
+                        agent_id="$2"
+                        shift 2
+                        ;;
+                    --confidence)
+                        confidence="$2"
+                        shift 2
+                        ;;
+                    --reasoning)
+                        reasoning="$2"
+                        shift 2
+                        ;;
+                    --phase)
+                        phase="$2"
+                        shift 2
+                        ;;
+                    --iteration)
+                        iteration="$2"
+                        shift 2
+                        ;;
+                    *)
+                        log_error "Unknown option: $1"
+                        show_usage
+                        exit 1
+                        ;;
+                esac
+            done
+
+            if [[ -z "$agent_id" || -z "$confidence" ]]; then
+                log_error "Missing required arguments for update"
+                show_usage
+                exit 1
+            fi
+
+            init_database
+            update_confidence "$agent_id" "$confidence" "$reasoning" "$phase" "$iteration"
+            ;;
+
+        "complete")
+            local agent_id=""
+            local confidence=""
+            local output=""
+            local phase=""
+            local iteration=""
+
+            while [[ $# -gt 0 ]]; do
+                case "$1" in
+                    --agent-id)
+                        agent_id="$2"
+                        shift 2
+                        ;;
+                    --confidence)
+                        confidence="$2"
+                        shift 2
+                        ;;
+                    --output)
+                        output="$2"
+                        shift 2
+                        ;;
+                    --phase)
+                        phase="$2"
+                        shift 2
+                        ;;
+                    --iteration)
+                        iteration="$2"
+                        shift 2
+                        ;;
+                    *)
+                        log_error "Unknown option: $1"
+                        show_usage
+                        exit 1
+                        ;;
+                esac
+            done
+
+            if [[ -z "$agent_id" || -z "$confidence" ]]; then
+                log_error "Missing required arguments for complete"
+                show_usage
+                exit 1
+            fi
+
+            init_database
+            complete_agent "$agent_id" "$confidence" "$output" "$phase" "$iteration"
+            ;;
+
+        "terminate")
+            local agent_id=""
+            local reason=""
+
+            while [[ $# -gt 0 ]]; do
+                case "$1" in
+                    --agent-id)
+                        agent_id="$2"
+                        shift 2
+                        ;;
+                    --reason)
+                        reason="$2"
+                        shift 2
+                        ;;
+                    *)
+                        log_error "Unknown option: $1"
+                        show_usage
+                        exit 1
+                        ;;
+                esac
+            done
+
+            if [[ -z "$agent_id" ]]; then
+                log_error "Missing required arguments for terminate"
+                show_usage
+                exit 1
+            fi
+
+            init_database
+            terminate_agent "$agent_id" "$reason"
+            ;;
+
+        "status")
+            local agent_id=""
+            local limit="10"
+
+            while [[ $# -gt 0 ]]; do
+                case "$1" in
+                    --agent-id)
+                        agent_id="$2"
+                        shift 2
+                        ;;
+                    --limit)
+                        limit="$2"
+                        shift 2
+                        ;;
+                    *)
+                        log_error "Unknown option: $1"
+                        show_usage
+                        exit 1
+                        ;;
+                esac
+            done
+
+            if [[ -z "$agent_id" ]]; then
+                log_error "Missing required arguments for status"
+                show_usage
+                exit 1
+            fi
+
+            init_database
+            query_status "$agent_id" "$limit"
+            ;;
+
+        "help"|"--help"|"-h")
+            show_usage
+            ;;
+
+        *)
+            log_error "Unknown action: $action"
+            show_usage
+            exit 1
+            ;;
+    esac
+}
+
+# Check for required dependencies
+check_dependencies() {
+    if ! command -v sqlite3 &> /dev/null; then
+        log_error "sqlite3 is required but not installed"
+        exit 1
+    fi
+
+    if ! command -v bc &> /dev/null; then
+        log_warning "bc is recommended for confidence calculations"
+    fi
+}
+
+# Main execution
+main() {
+    check_dependencies
+
+    if [[ $# -eq 0 ]]; then
+        show_usage
+        exit 1
+    fi
+
+    parse_args "$@"
+}
+
+# Execute main function
+main "$@"

package/.claude/skills/cfn-agent-lifecycle/lib/audit/simple-audit.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+
+# Simple Agent Audit Trail Script
+# Usage: ./simple-audit.sh <agent_id> <agent_type> <confidence> <status>
+
+# Source parameterized query library for SQL injection prevention
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../bootstrap/sqlite-params.sh"
+
+AGENT_ID="$1"
+AGENT_TYPE="$2"
+CONFIDENCE="${3:-0.0}"
+STATUS="${4:-spawned}"
+
+# Resolve database path relative to script location
+DB_PATH="${SCRIPT_DIR}/../../../claude-assets/skills/cfn-redis-coordination/data/cfn-loop.db"
+
+if [[ -z "$AGENT_ID" || -z "$AGENT_TYPE" ]]; then
+    echo "Usage: $0 <agent_id> <agent_type> [confidence] [status]"
+    exit 1
+fi
+
+# Ensure database directory exists
+mkdir -p "$(dirname "$DB_PATH")"
+
+# Create agents table if not exists (schema creation - no user input)
+sqlite3 "$DB_PATH" "CREATE TABLE IF NOT EXISTS agents (id TEXT PRIMARY KEY, type TEXT, status TEXT, confidence REAL, spawned_at TEXT, completed_at TEXT, metadata TEXT);" || {
+    echo "❌ Failed to initialize database at $DB_PATH" >&2
+    exit 1
+}
+
+# Validate confidence (must be numeric)
+if [[ ! "$CONFIDENCE" =~ ^[0-9]+(\.[0-9]+)?$ ]]; then
+    echo "❌ Invalid confidence value: $CONFIDENCE (must be numeric 0.0-1.0)" >&2
+    exit 1
+fi
+
+# Record agent activity using parameterized queries
+case "$STATUS" in
+    "spawned")
+        sqlite_upsert "$DB_PATH" \
+            "INSERT OR REPLACE INTO agents (id, type, status, spawned_at, metadata) VALUES (?1, ?2, 'spawned', datetime('now'), '{\"source\": \"task_mode\"}')" \
+            "$AGENT_ID" "$AGENT_TYPE" || {
+            echo "❌ Failed to record agent spawn" >&2
+            exit 1
+        }
+        ;;
+    "completed")
+        sqlite_update "$DB_PATH" \
+            "UPDATE agents SET status = 'completed', confidence = ?1, completed_at = datetime('now') WHERE id = ?2" \
+            "$CONFIDENCE" "$AGENT_ID" || {
+            echo "❌ Failed to record agent completion" >&2
+            exit 1
+        }
+        ;;
+esac
+
+echo "✅ Agent $AGENT_ID ($AGENT_TYPE) audit recorded: $STATUS"