claude-flow-novice 2.15.0 → 2.15.1

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-ad-campaigns/operations/get-campaign-performance.sh

@@ -0,0 +1,190 @@
+#!/bin/bash
+# CFN Marketing Ad Campaigns - Get Campaign Performance Operation
+# Fetches campaign performance metrics and analytics
+
+set -euo pipefail
+
+# Default values
+DATE_RANGE="last_7_days"
+METRICS="all"
+START_DATE=""
+END_DATE=""
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    --date-range)
+      DATE_RANGE="$2"
+      shift 2
+      ;;
+    --start-date)
+      START_DATE="$2"
+      shift 2
+      ;;
+    --end-date)
+      END_DATE="$2"
+      shift 2
+      ;;
+    --metrics)
+      METRICS="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '"$1"'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "${CAMPAIGN_ID:-}" ]]; then
+  echo '{"error": "Missing required parameter: --campaign-id", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate date range
+case "$DATE_RANGE" in
+  last_7_days|last_30_days|custom)
+    ;;
+  *)
+    echo '{"error": "Invalid date range: '"$DATE_RANGE"'. Supported: last_7_days, last_30_days, custom", "code": "INVALID_DATE_RANGE"}' >&2
+    exit 1
+    ;;
+esac
+
+# Validate custom date range
+if [[ "$DATE_RANGE" == "custom" ]]; then
+  if [[ -z "$START_DATE" ]]; then
+    echo '{"error": "Missing --start-date for custom date range", "code": "MISSING_PARAMETER"}' >&2
+    exit 1
+  fi
+  if [[ -z "$END_DATE" ]]; then
+    echo '{"error": "Missing --end-date for custom date range", "code": "MISSING_PARAMETER"}' >&2
+    exit 1
+  fi
+
+  # Validate date format (YYYY-MM-DD)
+  if ! [[ "$START_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+    echo '{"error": "Invalid start date format. Use YYYY-MM-DD", "code": "INVALID_DATE_FORMAT"}' >&2
+    exit 1
+  fi
+  if ! [[ "$END_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+    echo '{"error": "Invalid end date format. Use YYYY-MM-DD", "code": "INVALID_DATE_FORMAT"}' >&2
+    exit 1
+  fi
+fi
+
+# Calculate date range for predefined options
+if [[ "$DATE_RANGE" == "last_7_days" ]]; then
+  END_DATE=$(date +%Y-%m-%d)
+  START_DATE=$(date -d "7 days ago" +%Y-%m-%d 2>/dev/null || date -v-7d +%Y-%m-%d)
+elif [[ "$DATE_RANGE" == "last_30_days" ]]; then
+  END_DATE=$(date +%Y-%m-%d)
+  START_DATE=$(date -d "30 days ago" +%Y-%m-%d 2>/dev/null || date -v-30d +%Y-%m-%d)
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "N8N_BASE_URL environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "N8N_API_KEY environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# Build request payload
+PAYLOAD=$(jq -n \
+  --arg id "$CAMPAIGN_ID" \
+  --arg start "$START_DATE" \
+  --arg end "$END_DATE" \
+  --arg metrics "$METRICS" \
+  '{
+    campaign_id: $id,
+    date_range: {
+      start: $start,
+      end: $end
+    },
+    metrics: (if $metrics == "all" then null else ($metrics | split(",")) end)
+  }'
+)
+
+# Make API request
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "$N8N_BASE_URL/webhook/ad-campaigns/performance" 2>/dev/null || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle response
+case "$HTTP_CODE" in
+  200)
+    # Success - parse and format response
+    echo "$BODY" | jq \
+      --arg id "$CAMPAIGN_ID" \
+      --arg start "$START_DATE" \
+      --arg end "$END_DATE" \
+      '{
+        campaign_id: (.campaign_id // $id),
+        date_range: {
+          start: (.date_range.start // $start),
+          end: (.date_range.end // $end)
+        },
+        metrics: {
+          impressions: (.metrics.impressions // 0),
+          clicks: (.metrics.clicks // 0),
+          conversions: (.metrics.conversions // 0),
+          spend: (.metrics.spend // 0),
+          ctr: (.metrics.ctr // 0),
+          cpa: (.metrics.cpa // 0),
+          roas: (.metrics.roas // 0),
+          conversion_rate: (.metrics.conversion_rate // 0)
+        },
+        budget: {
+          total: (.budget.total // .budget.lifetime_budget),
+          spent: (.budget.spent // .metrics.spend // 0),
+          remaining: (.budget.remaining // (.budget.total - .budget.spent))
+        },
+        status: (.status // "unknown"),
+        platform: .platform
+      }'
+    exit 0
+    ;;
+  400)
+    echo '{"error": "Bad request - invalid performance query", "code": "API_BAD_REQUEST", "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+  401)
+    echo '{"error": "Authentication failed - check N8N_API_KEY", "code": "API_AUTH_FAILED"}' >&2
+    exit 2
+    ;;
+  404)
+    echo '{"error": "Campaign not found: '"$CAMPAIGN_ID"'", "code": "CAMPAIGN_NOT_FOUND"}' >&2
+    exit 1
+    ;;
+  429)
+    echo '{"error": "Rate limit exceeded - try again later", "code": "API_RATE_LIMIT"}' >&2
+    exit 2
+    ;;
+  503)
+    echo '{"error": "Performance data temporarily unavailable - try again later", "code": "SERVICE_UNAVAILABLE"}' >&2
+    exit 2
+    ;;
+  000)
+    echo '{"error": "Network error - unable to reach N8N instance", "code": "NETWORK_ERROR"}' >&2
+    exit 2
+    ;;
+  *)
+    echo '{"error": "Unexpected API response", "code": "API_ERROR", "http_code": '"$HTTP_CODE"', "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+esac

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-ad-campaigns/operations/pause-campaign.sh

@@ -0,0 +1,142 @@
+#!/bin/bash
+# CFN Marketing Ad Campaigns - Pause/Resume Campaign Operation
+# Controls campaign active status
+
+set -euo pipefail
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    --action)
+      ACTION="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '"$1"'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "${CAMPAIGN_ID:-}" ]]; then
+  echo '{"error": "Missing required parameter: --campaign-id", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+if [[ -z "${ACTION:-}" ]]; then
+  echo '{"error": "Missing required parameter: --action", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate action
+case "$ACTION" in
+  pause|resume)
+    ;;
+  *)
+    echo '{"error": "Invalid action: '"$ACTION"'. Supported: pause, resume", "code": "INVALID_ACTION"}' >&2
+    exit 1
+    ;;
+esac
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "N8N_BASE_URL environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "N8N_API_KEY environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# Build request payload
+PAYLOAD=$(jq -n \
+  --arg id "$CAMPAIGN_ID" \
+  --arg action "$ACTION" \
+  '{
+    campaign_id: $id,
+    action: $action
+  }'
+)
+
+# Make API request
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X PATCH \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "$N8N_BASE_URL/webhook/ad-campaigns/status" 2>/dev/null || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Determine expected status
+if [[ "$ACTION" == "pause" ]]; then
+  EXPECTED_STATUS="paused"
+  TIMESTAMP_FIELD="paused_at"
+else
+  EXPECTED_STATUS="active"
+  TIMESTAMP_FIELD="resumed_at"
+fi
+
+# Handle response
+case "$HTTP_CODE" in
+  200)
+    # Success - parse and format response
+    CURRENT_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    echo "$BODY" | jq \
+      --arg id "$CAMPAIGN_ID" \
+      --arg status "$EXPECTED_STATUS" \
+      --arg timestamp_field "$TIMESTAMP_FIELD" \
+      --arg timestamp "$CURRENT_TIME" \
+      '{
+        campaign_id: (.campaign_id // $id),
+        status: (.status // $status),
+        ($timestamp_field): (.[$timestamp_field] // $timestamp),
+        budget_remaining: .budget_remaining,
+        daily_budget: .daily_budget,
+        lifetime_budget: .lifetime_budget
+      }'
+    exit 0
+    ;;
+  400)
+    echo '{"error": "Bad request - invalid status change", "code": "API_BAD_REQUEST", "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+  401)
+    echo '{"error": "Authentication failed - check N8N_API_KEY", "code": "API_AUTH_FAILED"}' >&2
+    exit 2
+    ;;
+  404)
+    echo '{"error": "Campaign not found: '"$CAMPAIGN_ID"'", "code": "CAMPAIGN_NOT_FOUND"}' >&2
+    exit 1
+    ;;
+  409)
+    # Campaign already in requested state
+    if [[ "$ACTION" == "pause" ]]; then
+      MSG="Campaign already paused"
+    else
+      MSG="Campaign already active"
+    fi
+    echo '{"error": "'"$MSG"'", "code": "INVALID_STATE_TRANSITION", "details": '"${BODY:-null}"'}' >&2
+    exit 1
+    ;;
+  429)
+    echo '{"error": "Rate limit exceeded - try again later", "code": "API_RATE_LIMIT"}' >&2
+    exit 2
+    ;;
+  000)
+    echo '{"error": "Network error - unable to reach N8N instance", "code": "NETWORK_ERROR"}' >&2
+    exit 2
+    ;;
+  *)
+    echo '{"error": "Unexpected API response", "code": "API_ERROR", "http_code": '"$HTTP_CODE"', "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+esac

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-ad-campaigns/operations/set-budget.sh

@@ -0,0 +1,181 @@
+#!/bin/bash
+# CFN Marketing Ad Campaigns - Set Budget Operation
+# Updates campaign budget with validation
+
+set -euo pipefail
+
+# Budget limits (hard-coded)
+DAILY_MIN=1
+DAILY_MAX=500
+LIFETIME_MIN=10
+LIFETIME_MAX=5000
+
+# Initialize optional parameters
+DAILY_BUDGET=""
+LIFETIME_BUDGET=""
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    --daily-budget)
+      DAILY_BUDGET="$2"
+      shift 2
+      ;;
+    --lifetime-budget)
+      LIFETIME_BUDGET="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '"$1"'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "${CAMPAIGN_ID:-}" ]]; then
+  echo '{"error": "Missing required parameter: --campaign-id", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+if [[ -z "$DAILY_BUDGET" ]] && [[ -z "$LIFETIME_BUDGET" ]]; then
+  echo '{"error": "At least one budget parameter required (--daily-budget or --lifetime-budget)", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate daily budget if provided
+if [[ -n "$DAILY_BUDGET" ]]; then
+  if (( $(echo "$DAILY_BUDGET < $DAILY_MIN" | bc -l) )); then
+    echo '{"error": "Daily budget below minimum ($'"$DAILY_MIN"')", "code": "BUDGET_TOO_LOW", "details": {"field": "daily_budget", "min": '"$DAILY_MIN"', "provided": '"$DAILY_BUDGET"'}}' >&2
+    exit 3
+  fi
+
+  if (( $(echo "$DAILY_BUDGET > $DAILY_MAX" | bc -l) )); then
+    echo '{"error": "Daily budget exceeds maximum ($'"$DAILY_MAX"')", "code": "BUDGET_EXCEEDED", "details": {"field": "daily_budget", "max": '"$DAILY_MAX"', "provided": '"$DAILY_BUDGET"'}}' >&2
+    exit 3
+  fi
+fi
+
+# Validate lifetime budget if provided
+if [[ -n "$LIFETIME_BUDGET" ]]; then
+  if (( $(echo "$LIFETIME_BUDGET < $LIFETIME_MIN" | bc -l) )); then
+    echo '{"error": "Lifetime budget below minimum ($'"$LIFETIME_MIN"')", "code": "BUDGET_TOO_LOW", "details": {"field": "lifetime_budget", "min": '"$LIFETIME_MIN"', "provided": '"$LIFETIME_BUDGET"'}}' >&2
+    exit 3
+  fi
+
+  if (( $(echo "$LIFETIME_BUDGET > $LIFETIME_MAX" | bc -l) )); then
+    echo '{"error": "Lifetime budget exceeds maximum ($'"$LIFETIME_MAX"')", "code": "BUDGET_EXCEEDED", "details": {"field": "lifetime_budget", "max": '"$LIFETIME_MAX"', "provided": '"$LIFETIME_BUDGET"'}}' >&2
+    exit 3
+  fi
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "N8N_BASE_URL environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "N8N_API_KEY environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# Build request payload
+if [[ -n "$DAILY_BUDGET" ]] && [[ -n "$LIFETIME_BUDGET" ]]; then
+  PAYLOAD=$(jq -n \
+    --arg id "$CAMPAIGN_ID" \
+    --argjson daily "$DAILY_BUDGET" \
+    --argjson lifetime "$LIFETIME_BUDGET" \
+    '{
+      campaign_id: $id,
+      daily_budget: $daily,
+      lifetime_budget: $lifetime
+    }'
+  )
+elif [[ -n "$DAILY_BUDGET" ]]; then
+  PAYLOAD=$(jq -n \
+    --arg id "$CAMPAIGN_ID" \
+    --argjson daily "$DAILY_BUDGET" \
+    '{
+      campaign_id: $id,
+      daily_budget: $daily
+    }'
+  )
+else
+  PAYLOAD=$(jq -n \
+    --arg id "$CAMPAIGN_ID" \
+    --argjson lifetime "$LIFETIME_BUDGET" \
+    '{
+      campaign_id: $id,
+      lifetime_budget: $lifetime
+    }'
+  )
+fi
+
+# Make API request
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X PATCH \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "$N8N_BASE_URL/webhook/ad-campaigns/budget" 2>/dev/null || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle response
+case "$HTTP_CODE" in
+  200)
+    # Success - parse and format response
+    echo "$BODY" | jq \
+      --arg id "$CAMPAIGN_ID" \
+      '{
+        campaign_id: (.campaign_id // $id),
+        daily_budget: (if .daily_budget then {
+          previous: .daily_budget.previous,
+          updated: .daily_budget.updated
+        } else null end),
+        lifetime_budget: (if .lifetime_budget then {
+          previous: .lifetime_budget.previous,
+          updated: .lifetime_budget.updated
+        } else null end),
+        budget_remaining: .budget_remaining,
+        current_spend: .current_spend
+      }'
+    exit 0
+    ;;
+  400)
+    # Check if error is due to budget constraint
+    if echo "$BODY" | jq -e '.code == "BUDGET_BELOW_SPEND"' >/dev/null 2>&1; then
+      CURRENT_SPEND=$(echo "$BODY" | jq -r '.current_spend // "unknown"')
+      echo '{"error": "Cannot reduce lifetime budget below current spend ($'"$CURRENT_SPEND"')", "code": "BUDGET_CONSTRAINT_VIOLATION", "details": '"${BODY:-null}"'}' >&2
+      exit 3
+    fi
+    echo '{"error": "Bad request - invalid budget parameters", "code": "API_BAD_REQUEST", "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+  401)
+    echo '{"error": "Authentication failed - check N8N_API_KEY", "code": "API_AUTH_FAILED"}' >&2
+    exit 2
+    ;;
+  404)
+    echo '{"error": "Campaign not found: '"$CAMPAIGN_ID"'", "code": "CAMPAIGN_NOT_FOUND"}' >&2
+    exit 1
+    ;;
+  429)
+    echo '{"error": "Rate limit exceeded - try again later", "code": "API_RATE_LIMIT"}' >&2
+    exit 2
+    ;;
+  000)
+    echo '{"error": "Network error - unable to reach N8N instance", "code": "NETWORK_ERROR"}' >&2
+    exit 2
+    ;;
+  *)
+    echo '{"error": "Unexpected API response", "code": "API_ERROR", "http_code": '"$HTTP_CODE"', "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+esac

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-ad-campaigns/operations/update-bid-strategy.sh

@@ -0,0 +1,133 @@
+#!/bin/bash
+# CFN Marketing Ad Campaigns - Update Bid Strategy Operation
+# Modifies campaign bidding strategy
+
+set -euo pipefail
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    --bid-strategy)
+      BID_STRATEGY="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '"$1"'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "${CAMPAIGN_ID:-}" ]]; then
+  echo '{"error": "Missing required parameter: --campaign-id", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+if [[ -z "${BID_STRATEGY:-}" ]]; then
+  echo '{"error": "Missing required parameter: --bid-strategy", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate bid strategy
+case "$BID_STRATEGY" in
+  manual_cpc|enhanced_cpc|maximize_conversions|target_cpa|target_roas)
+    ;;
+  *)
+    echo '{"error": "Invalid bid strategy: '"$BID_STRATEGY"'. Supported: manual_cpc, enhanced_cpc, maximize_conversions, target_cpa, target_roas", "code": "INVALID_BID_STRATEGY"}' >&2
+    exit 1
+    ;;
+esac
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "N8N_BASE_URL environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "N8N_API_KEY environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# Build request payload
+PAYLOAD=$(jq -n \
+  --arg id "$CAMPAIGN_ID" \
+  --arg strategy "$BID_STRATEGY" \
+  '{
+    campaign_id: $id,
+    bid_strategy: $strategy
+  }'
+)
+
+# Make API request
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X PATCH \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "$N8N_BASE_URL/webhook/ad-campaigns/bid-strategy" 2>/dev/null || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle response
+case "$HTTP_CODE" in
+  200)
+    # Success - parse and format response
+    echo "$BODY" | jq \
+      --arg id "$CAMPAIGN_ID" \
+      --arg strategy "$BID_STRATEGY" \
+      '{
+        campaign_id: (.campaign_id // $id),
+        bid_strategy: {
+          previous: .bid_strategy.previous,
+          updated: (.bid_strategy.updated // $strategy)
+        },
+        estimated_impact: (if .estimated_impact then {
+          cpa_change: .estimated_impact.cpa_change,
+          conversion_volume: .estimated_impact.conversion_volume,
+          roas_change: .estimated_impact.roas_change
+        } else {
+          cpa_change: "calculating",
+          conversion_volume: "calculating"
+        } end),
+        status: (.status // "active"),
+        updated_at: (.updated_at // (now | strftime("%Y-%m-%dT%H:%M:%SZ")))
+      }'
+    exit 0
+    ;;
+  400)
+    echo '{"error": "Bad request - invalid bid strategy parameters", "code": "API_BAD_REQUEST", "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+  401)
+    echo '{"error": "Authentication failed - check N8N_API_KEY", "code": "API_AUTH_FAILED"}' >&2
+    exit 2
+    ;;
+  404)
+    echo '{"error": "Campaign not found: '"$CAMPAIGN_ID"'", "code": "CAMPAIGN_NOT_FOUND"}' >&2
+    exit 1
+    ;;
+  409)
+    # Campaign in state that prevents bid strategy change
+    echo '{"error": "Cannot change bid strategy - campaign must be active", "code": "INVALID_CAMPAIGN_STATE", "details": '"${BODY:-null}"'}' >&2
+    exit 1
+    ;;
+  429)
+    echo '{"error": "Rate limit exceeded - try again later", "code": "API_RATE_LIMIT"}' >&2
+    exit 2
+    ;;
+  000)
+    echo '{"error": "Network error - unable to reach N8N instance", "code": "NETWORK_ERROR"}' >&2
+    exit 2
+    ;;
+  *)
+    echo '{"error": "Unexpected API response", "code": "API_ERROR", "http_code": '"$HTTP_CODE"', "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+esac