claude-flow-novice 2.14.37 → 2.15.1

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-sms-campaigns/operations/send-sms.sh

@@ -0,0 +1,181 @@
+#!/bin/bash
+# CFN Marketing SMS Campaigns - Send SMS Operation
+# Version: 1.0.0
+# Purpose: Send single SMS message with TCPA compliance checks
+
+set -euo pipefail
+
+# Parse arguments
+PHONE=""
+MESSAGE=""
+CAMPAIGN_ID=""
+SENDER_ID="${SMS_SENDER_ID:-CFN Marketing}"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --phone)
+      PHONE="$2"
+      shift 2
+      ;;
+    --message)
+      MESSAGE="$2"
+      shift 2
+      ;;
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    --sender-id)
+      SENDER_ID="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '$1'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "$PHONE" ]]; then
+  echo '{"error": "Missing required parameter: --phone", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+if [[ -z "$MESSAGE" ]]; then
+  echo '{"error": "Missing required parameter: --message", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate phone format (E.164: +1XXXXXXXXXX)
+if ! echo "$PHONE" | grep -qE '^\+[1-9][0-9]{1,14}$'; then
+  echo '{"error": "Invalid phone format. Use E.164 format (+1XXXXXXXXXX)", "code": "INVALID_PHONE"}' >&2
+  exit 1
+fi
+
+# Validate message length (160 characters for standard SMS)
+if [[ ${#MESSAGE} -gt 160 ]]; then
+  echo '{"error": "Message too long. Maximum 160 characters", "code": "MESSAGE_TOO_LONG", "length": '${#MESSAGE}'}' >&2
+  exit 1
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "Environment variable N8N_BASE_URL not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "Environment variable N8N_API_KEY not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# CRITICAL: TCPA Compliance Check #1 - Verify opt-in
+if command -v redis-cli &> /dev/null; then
+  OPT_IN=$(redis-cli GET "sms:opt_in:$PHONE" 2>/dev/null || echo "false")
+  if [[ "$OPT_IN" != "true" ]]; then
+    echo '{"error": "Recipient has not opted-in (TCPA violation)", "code": "NO_OPT_IN", "phone": "'"$PHONE"'", "severity": "critical"}' >&2
+    exit 3
+  fi
+else
+  echo '{"error": "Redis not available for opt-in verification", "code": "REDIS_UNAVAILABLE"}' >&2
+  exit 2
+fi
+
+# CRITICAL: TCPA Compliance Check #2 - Check Do Not Call registry
+DNC=$(redis-cli GET "sms:dnc:$PHONE" 2>/dev/null || echo "false")
+if [[ "$DNC" == "true" ]]; then
+  echo '{"error": "Phone number on DNC registry", "code": "DNC_VIOLATION", "phone": "'"$PHONE"'", "severity": "critical"}' >&2
+  exit 3
+fi
+
+# CRITICAL: TCPA Compliance Check #3 - Time restrictions (8 AM - 9 PM)
+# Note: Requires recipient timezone lookup in production
+CURRENT_HOUR=$(date +%H)
+if [[ "$CURRENT_HOUR" -lt 8 ]] || [[ "$CURRENT_HOUR" -ge 21 ]]; then
+  echo '{"error": "Time restriction violation (8 AM - 9 PM)", "code": "TIME_RESTRICTION", "current_hour": '$CURRENT_HOUR', "severity": "critical"}' >&2
+  exit 3
+fi
+
+# Ensure opt-out instructions included (TCPA requirement)
+if ! echo "$MESSAGE" | grep -qiE 'STOP|opt.*out|unsubscribe'; then
+  echo '{"error": "Message must include opt-out instructions (TCPA requirement)", "code": "MISSING_OPT_OUT", "severity": "critical"}' >&2
+  exit 3
+fi
+
+# Generate message ID
+MESSAGE_ID="sms_$(date +%s)_$(shuf -i 10000-99999 -n 1)"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# Prepare request payload
+PAYLOAD=$(jq -n \
+  --arg phone "$PHONE" \
+  --arg message "$MESSAGE" \
+  --arg campaign_id "$CAMPAIGN_ID" \
+  --arg sender_id "$SENDER_ID" \
+  --arg message_id "$MESSAGE_ID" \
+  --arg timestamp "$TIMESTAMP" \
+  '{
+    phone: $phone,
+    message: $message,
+    campaign_id: $campaign_id,
+    sender_id: $sender_id,
+    message_id: $message_id,
+    sent_at: $timestamp,
+    compliance_verified: true
+  }')
+
+# Send SMS via n8n webhook
+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/sms/send" 2>&1) || {
+  echo '{"error": "Network error: Failed to connect to n8n", "code": "NETWORK_ERROR"}' >&2
+  exit 2
+}
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle HTTP errors
+if [[ "$HTTP_CODE" -ge 400 ]]; then
+  if [[ "$HTTP_CODE" -eq 401 ]]; then
+    echo '{"error": "Authentication failed", "code": "AUTH_ERROR"}' >&2
+    exit 2
+  else
+    ERROR_MSG=$(echo "$BODY" | jq -r '.error // "Unknown API error"' 2>/dev/null || echo "Unknown API error")
+    echo '{"error": "'"$ERROR_MSG"'", "code": "API_ERROR", "http_code": '$HTTP_CODE'}' >&2
+    exit 2
+  fi
+fi
+
+# Parse response
+if ! echo "$BODY" | jq empty 2>/dev/null; then
+  echo '{"error": "Invalid JSON response from API", "code": "INVALID_RESPONSE"}' >&2
+  exit 2
+fi
+
+# Log successful send (for audit trail)
+redis-cli LPUSH "sms:sent_log:$PHONE" "$MESSAGE_ID:$TIMESTAMP" > /dev/null 2>&1 || true
+redis-cli LTRIM "sms:sent_log:$PHONE" 0 99 > /dev/null 2>&1 || true
+
+# Return success response
+echo "$BODY" | jq \
+  --arg message_id "$MESSAGE_ID" \
+  --arg phone "$PHONE" \
+  --arg timestamp "$TIMESTAMP" \
+  '{
+    message_id: ($message_id),
+    phone: $phone,
+    status: (.status // "sent"),
+    sent_at: $timestamp,
+    compliance_checks: {
+      opt_in_verified: true,
+      dnc_cleared: true,
+      time_restriction_ok: true
+    }
+  }'
+
+exit 0

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-social-publishing/SKILL.md

@@ -0,0 +1,108 @@
+# CFN Marketing Social Publishing Skill
+
+## Purpose
+Manage social media publishing through n8n workflow integration. Create, schedule, and analyze social media posts across multiple platforms.
+
+## Operations
+
+### 1. create-post.sh
+Create a new social media post.
+
+**Parameters:**
+- `--content` (required): Post text content
+- `--platforms` (required): Comma-separated platforms (facebook,twitter,linkedin,instagram)
+- `--media-ids` (optional): Comma-separated media attachment IDs
+- `--link` (optional): URL to include in post
+- `--hashtags` (optional): Comma-separated hashtags
+
+**Example:**
+```bash
+./operations/create-post.sh \
+  --content "Check out our new product launch!" \
+  --platforms "facebook,twitter,linkedin" \
+  --media-ids "media-123,media-456" \
+  --link "https://company.com/product" \
+  --hashtags "ProductLaunch,Innovation"
+```
+
+### 2. schedule-post.sh
+Schedule post publication.
+
+**Parameters:**
+- `--post-id` (required): Post identifier
+- `--schedule-time` (required): ISO 8601 datetime
+- `--timezone` (optional): Timezone (default: UTC)
+
+**Example:**
+```bash
+./operations/schedule-post.sh \
+  --post-id "post-789" \
+  --schedule-time "2025-11-01T14:00:00Z" \
+  --timezone "America/Los_Angeles"
+```
+
+### 3. upload-media.sh
+Upload media for social posts.
+
+**Parameters:**
+- `--file-path` (required): Local file path
+- `--media-type` (required): Type (image, video, gif)
+- `--alt-text` (optional): Accessibility description
+
+**Example:**
+```bash
+./operations/upload-media.sh \
+  --file-path "/path/to/image.jpg" \
+  --media-type "image" \
+  --alt-text "Product showcase image"
+```
+
+### 4. get-post-stats.sh
+Retrieve post engagement statistics.
+
+**Parameters:**
+- `--post-id` (required): Post identifier
+
+**Example:**
+```bash
+./operations/get-post-stats.sh --post-id "post-789"
+```
+
+### 5. delete-post.sh
+Delete a scheduled or published post.
+
+**Parameters:**
+- `--post-id` (required): Post identifier
+- `--platforms` (optional): Specific platforms to delete from (default: all)
+
+**Example:**
+```bash
+./operations/delete-post.sh \
+  --post-id "post-789" \
+  --platforms "facebook,twitter"
+```
+
+## N8N Integration
+
+All operations invoke n8n workflows via HTTP POST to endpoints configured in `.env`:
+- `N8N_BASE_URL`: Base URL for n8n instance
+- `N8N_API_KEY`: Authentication key
+
+## Error Handling
+
+Scripts return:
+- Exit code 0: Success
+- Exit code 1: Parameter validation error
+- Exit code 2: Network/API error
+- Exit code 3: Authentication error
+
+## Response Format
+
+All operations return JSON with structure:
+```json
+{
+  "success": true,
+  "data": { ... },
+  "message": "Operation completed successfully"
+}
+```

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-social-publishing/operations/create-post.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+set -euo pipefail
+
+# Create social media post via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+CONTENT=""
+PLATFORMS=""
+MEDIA_IDS=""
+LINK=""
+HASHTAGS=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --content)
+      CONTENT="$2"
+      shift 2
+      ;;
+    --platforms)
+      PLATFORMS="$2"
+      shift 2
+      ;;
+    --media-ids)
+      MEDIA_IDS="$2"
+      shift 2
+      ;;
+    --link)
+      LINK="$2"
+      shift 2
+      ;;
+    --hashtags)
+      HASHTAGS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$CONTENT" ]]; then
+  echo "Error: --content is required" >&2
+  exit 1
+fi
+
+if [[ -z "$PLATFORMS" ]]; then
+  echo "Error: --platforms is required" >&2
+  exit 1
+fi
+
+# Convert comma-separated values to JSON arrays
+PLATFORMS_ARRAY=$(echo "$PLATFORMS" | jq -R 'split(",")')
+MEDIA_IDS_ARRAY=$(if [[ -n "$MEDIA_IDS" ]]; then echo "$MEDIA_IDS" | jq -R 'split(",")'; else echo "[]"; fi)
+HASHTAGS_ARRAY=$(if [[ -n "$HASHTAGS" ]]; then echo "$HASHTAGS" | jq -R 'split(",")'; else echo "[]"; fi)
+
+PAYLOAD=$(jq -n \
+  --arg content "$CONTENT" \
+  --argjson platforms "$PLATFORMS_ARRAY" \
+  --argjson mediaIds "$MEDIA_IDS_ARRAY" \
+  --arg link "$LINK" \
+  --argjson hashtags "$HASHTAGS_ARRAY" \
+  '{
+    content: $content,
+    platforms: $platforms,
+    mediaIds: $mediaIds,
+    link: $link,
+    hashtags: $hashtags
+  }')
+
+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/marketing/social/create-post" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-social-publishing/operations/delete-post.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+set -euo pipefail
+
+# Delete social media post via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+POST_ID=""
+PLATFORMS=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --post-id)
+      POST_ID="$2"
+      shift 2
+      ;;
+    --platforms)
+      PLATFORMS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$POST_ID" ]]; then
+  echo "Error: --post-id is required" >&2
+  exit 1
+fi
+
+# Convert comma-separated platforms to JSON array
+PLATFORMS_ARRAY=$(if [[ -n "$PLATFORMS" ]]; then echo "$PLATFORMS" | jq -R 'split(",")'; else echo "[]"; fi)
+
+PAYLOAD=$(jq -n \
+  --arg postId "$POST_ID" \
+  --argjson platforms "$PLATFORMS_ARRAY" \
+  '{
+    postId: $postId,
+    platforms: $platforms
+  }')
+
+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/marketing/social/delete-post" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-social-publishing/operations/get-post-stats.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+set -euo pipefail
+
+# Get social media post statistics via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+POST_ID=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --post-id)
+      POST_ID="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$POST_ID" ]]; then
+  echo "Error: --post-id is required" >&2
+  exit 1
+fi
+
+PAYLOAD=$(jq -n \
+  --arg postId "$POST_ID" \
+  '{
+    postId: $postId
+  }')
+
+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/marketing/social/post-stats" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-social-publishing/operations/schedule-post.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+set -euo pipefail
+
+# Schedule social media post via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+POST_ID=""
+SCHEDULE_TIME=""
+TIMEZONE="UTC"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --post-id)
+      POST_ID="$2"
+      shift 2
+      ;;
+    --schedule-time)
+      SCHEDULE_TIME="$2"
+      shift 2
+      ;;
+    --timezone)
+      TIMEZONE="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$POST_ID" ]]; then
+  echo "Error: --post-id is required" >&2
+  exit 1
+fi
+
+if [[ -z "$SCHEDULE_TIME" ]]; then
+  echo "Error: --schedule-time is required" >&2
+  exit 1
+fi
+
+PAYLOAD=$(jq -n \
+  --arg postId "$POST_ID" \
+  --arg scheduleTime "$SCHEDULE_TIME" \
+  --arg timezone "$TIMEZONE" \
+  '{
+    postId: $postId,
+    scheduleTime: $scheduleTime,
+    timezone: $timezone
+  }')
+
+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/marketing/social/schedule-post" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi