claude-flow-novice 2.10.4 → 2.10.6

package/claude-assets/skills/cfn-marketing-crm-contacts/operations/create-contact.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+set -euo pipefail
+
+# Create CRM contact 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:-}"
+
+EMAIL=""
+FIRST_NAME=""
+LAST_NAME=""
+COMPANY=""
+PHONE=""
+CUSTOM_FIELDS="{}"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --email)
+      EMAIL="$2"
+      shift 2
+      ;;
+    --first-name)
+      FIRST_NAME="$2"
+      shift 2
+      ;;
+    --last-name)
+      LAST_NAME="$2"
+      shift 2
+      ;;
+    --company)
+      COMPANY="$2"
+      shift 2
+      ;;
+    --phone)
+      PHONE="$2"
+      shift 2
+      ;;
+    --custom-fields)
+      CUSTOM_FIELDS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$EMAIL" ]]; then
+  echo "Error: --email is required" >&2
+  exit 1
+fi
+
+# Validate email format (basic check)
+if [[ ! "$EMAIL" =~ ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ ]]; then
+  echo "Error: Invalid email format" >&2
+  exit 1
+fi
+
+# Validate custom fields JSON
+if ! echo "$CUSTOM_FIELDS" | jq empty 2>/dev/null; then
+  echo "Error: --custom-fields must be valid JSON" >&2
+  exit 1
+fi
+
+PAYLOAD=$(jq -n \
+  --arg email "$EMAIL" \
+  --arg firstName "$FIRST_NAME" \
+  --arg lastName "$LAST_NAME" \
+  --arg company "$COMPANY" \
+  --arg phone "$PHONE" \
+  --argjson customFields "$CUSTOM_FIELDS" \
+  '{
+    email: $email,
+    firstName: $firstName,
+    lastName: $lastName,
+    company: $company,
+    phone: $phone,
+    customFields: $customFields
+  }')
+
+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/crm/create-contact" || 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/skills/cfn-marketing-crm-contacts/operations/get-contact.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+set -euo pipefail
+
+# Get CRM contact information 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:-}"
+
+CONTACT_ID=""
+EMAIL=""
+INCLUDE_HISTORY="false"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --contact-id)
+      CONTACT_ID="$2"
+      shift 2
+      ;;
+    --email)
+      EMAIL="$2"
+      shift 2
+      ;;
+    --include-history)
+      INCLUDE_HISTORY="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$CONTACT_ID" ]] && [[ -z "$EMAIL" ]]; then
+  echo "Error: Either --contact-id or --email is required" >&2
+  exit 1
+fi
+
+# Validate include-history boolean
+if [[ ! "$INCLUDE_HISTORY" =~ ^(true|false)$ ]]; then
+  echo "Error: --include-history must be true or false" >&2
+  exit 1
+fi
+
+PAYLOAD=$(jq -n \
+  --arg contactId "$CONTACT_ID" \
+  --arg email "$EMAIL" \
+  --argjson includeHistory "$(if [[ $INCLUDE_HISTORY == "true" ]]; then echo true; else echo false; fi)" \
+  '{
+    contactId: $contactId,
+    email: $email,
+    includeHistory: $includeHistory
+  }')
+
+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/crm/get-contact" || 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/skills/cfn-marketing-crm-contacts/operations/remove-from-segment.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+set -euo pipefail
+
+# Remove contact from CRM segment 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:-}"
+
+CONTACT_ID=""
+SEGMENT_ID=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --contact-id)
+      CONTACT_ID="$2"
+      shift 2
+      ;;
+    --segment-id)
+      SEGMENT_ID="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$CONTACT_ID" ]]; then
+  echo "Error: --contact-id is required" >&2
+  exit 1
+fi
+
+if [[ -z "$SEGMENT_ID" ]]; then
+  echo "Error: --segment-id is required" >&2
+  exit 1
+fi
+
+PAYLOAD=$(jq -n \
+  --arg contactId "$CONTACT_ID" \
+  --arg segmentId "$SEGMENT_ID" \
+  '{
+    contactId: $contactId,
+    segmentId: $segmentId
+  }')
+
+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/crm/remove-from-segment" || 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/skills/cfn-marketing-crm-contacts/operations/update-contact.sh

@@ -0,0 +1,120 @@
+#!/bin/bash
+set -euo pipefail
+
+# Update CRM contact 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:-}"
+
+CONTACT_ID=""
+EMAIL=""
+FIRST_NAME=""
+LAST_NAME=""
+COMPANY=""
+PHONE=""
+CUSTOM_FIELDS="{}"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --contact-id)
+      CONTACT_ID="$2"
+      shift 2
+      ;;
+    --email)
+      EMAIL="$2"
+      shift 2
+      ;;
+    --first-name)
+      FIRST_NAME="$2"
+      shift 2
+      ;;
+    --last-name)
+      LAST_NAME="$2"
+      shift 2
+      ;;
+    --company)
+      COMPANY="$2"
+      shift 2
+      ;;
+    --phone)
+      PHONE="$2"
+      shift 2
+      ;;
+    --custom-fields)
+      CUSTOM_FIELDS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$CONTACT_ID" ]]; then
+  echo "Error: --contact-id is required" >&2
+  exit 1
+fi
+
+# Validate email format if provided
+if [[ -n "$EMAIL" ]] && [[ ! "$EMAIL" =~ ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ ]]; then
+  echo "Error: Invalid email format" >&2
+  exit 1
+fi
+
+# Validate custom fields JSON
+if ! echo "$CUSTOM_FIELDS" | jq empty 2>/dev/null; then
+  echo "Error: --custom-fields must be valid JSON" >&2
+  exit 1
+fi
+
+PAYLOAD=$(jq -n \
+  --arg contactId "$CONTACT_ID" \
+  --arg email "$EMAIL" \
+  --arg firstName "$FIRST_NAME" \
+  --arg lastName "$LAST_NAME" \
+  --arg company "$COMPANY" \
+  --arg phone "$PHONE" \
+  --argjson customFields "$CUSTOM_FIELDS" \
+  '{
+    contactId: $contactId,
+    email: $email,
+    firstName: $firstName,
+    lastName: $lastName,
+    company: $company,
+    phone: $phone,
+    customFields: $customFields
+  }')
+
+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/crm/update-contact" || 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/skills/cfn-marketing-email-campaigns/SKILL.md

@@ -0,0 +1,106 @@
+# CFN Marketing Email Campaigns Skill
+
+## Purpose
+Manage email marketing campaigns through n8n workflow integration. Create, schedule, test, and analyze email campaigns.
+
+## Operations
+
+### 1. create-campaign.sh
+Create a new email campaign.
+
+**Parameters:**
+- `--name` (required): Campaign name
+- `--subject` (required): Email subject line
+- `--template-id` (required): Email template identifier
+- `--segment-id` (required): Target audience segment
+- `--from-email` (optional): Sender email address
+- `--from-name` (optional): Sender name
+
+**Example:**
+```bash
+./operations/create-campaign.sh \
+  --name "Spring Sale 2025" \
+  --subject "Save 30% This Spring!" \
+  --template-id "spring-sale-template" \
+  --segment-id "active-customers" \
+  --from-email "marketing@company.com" \
+  --from-name "Marketing Team"
+```
+
+### 2. schedule-campaign.sh
+Schedule campaign delivery.
+
+**Parameters:**
+- `--campaign-id` (required): Campaign identifier
+- `--schedule-time` (required): ISO 8601 datetime (e.g., 2025-11-01T10:00:00Z)
+- `--timezone` (optional): Timezone (default: UTC)
+
+**Example:**
+```bash
+./operations/schedule-campaign.sh \
+  --campaign-id "campaign-123" \
+  --schedule-time "2025-11-01T10:00:00Z" \
+  --timezone "America/New_York"
+```
+
+### 3. send-test-email.sh
+Send test email to specified addresses.
+
+**Parameters:**
+- `--campaign-id` (required): Campaign identifier
+- `--recipients` (required): Comma-separated email addresses
+
+**Example:**
+```bash
+./operations/send-test-email.sh \
+  --campaign-id "campaign-123" \
+  --recipients "test1@company.com,test2@company.com"
+```
+
+### 4. get-campaign-stats.sh
+Retrieve campaign performance statistics.
+
+**Parameters:**
+- `--campaign-id` (required): Campaign identifier
+
+**Example:**
+```bash
+./operations/get-campaign-stats.sh --campaign-id "campaign-123"
+```
+
+### 5. list-templates.sh
+List available email templates.
+
+**Parameters:**
+- `--category` (optional): Filter by template category
+- `--limit` (optional): Maximum results (default: 50)
+
+**Example:**
+```bash
+./operations/list-templates.sh --category "promotional" --limit 20
+```
+
+## 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/skills/cfn-marketing-email-campaigns/operations/create-campaign.sh

@@ -0,0 +1,123 @@
+#!/bin/bash
+set -euo pipefail
+
+# Create email campaign via n8n workflow
+
+# Load environment
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+# Parse parameters
+NAME=""
+SUBJECT=""
+TEMPLATE_ID=""
+SEGMENT_ID=""
+FROM_EMAIL="marketing@company.com"
+FROM_NAME="Marketing Team"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --name)
+      NAME="$2"
+      shift 2
+      ;;
+    --subject)
+      SUBJECT="$2"
+      shift 2
+      ;;
+    --template-id)
+      TEMPLATE_ID="$2"
+      shift 2
+      ;;
+    --segment-id)
+      SEGMENT_ID="$2"
+      shift 2
+      ;;
+    --from-email)
+      FROM_EMAIL="$2"
+      shift 2
+      ;;
+    --from-name)
+      FROM_NAME="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "$NAME" ]]; then
+  echo "Error: --name is required" >&2
+  exit 1
+fi
+
+if [[ -z "$SUBJECT" ]]; then
+  echo "Error: --subject is required" >&2
+  exit 1
+fi
+
+if [[ -z "$TEMPLATE_ID" ]]; then
+  echo "Error: --template-id is required" >&2
+  exit 1
+fi
+
+if [[ -z "$SEGMENT_ID" ]]; then
+  echo "Error: --segment-id is required" >&2
+  exit 1
+fi
+
+# Build JSON payload
+PAYLOAD=$(jq -n \
+  --arg name "$NAME" \
+  --arg subject "$SUBJECT" \
+  --arg templateId "$TEMPLATE_ID" \
+  --arg segmentId "$SEGMENT_ID" \
+  --arg fromEmail "$FROM_EMAIL" \
+  --arg fromName "$FROM_NAME" \
+  '{
+    name: $name,
+    subject: $subject,
+    templateId: $templateId,
+    segmentId: $segmentId,
+    fromEmail: $fromEmail,
+    fromName: $fromName
+  }')
+
+# Call n8n workflow
+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/email/create-campaign" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle HTTP errors
+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
+
+# Parse and return response
+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/skills/cfn-marketing-email-campaigns/operations/get-campaign-stats.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+set -euo pipefail
+
+# Get email campaign 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:-}"
+
+CAMPAIGN_ID=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$CAMPAIGN_ID" ]]; then
+  echo "Error: --campaign-id is required" >&2
+  exit 1
+fi
+
+PAYLOAD=$(jq -n \
+  --arg campaignId "$CAMPAIGN_ID" \
+  '{
+    campaignId: $campaignId
+  }')
+
+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/email/campaign-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