claude-flow-novice 2.15.0 → 2.15.2

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-competitive-intel/operations/get-trending-topics.sh

@@ -0,0 +1,147 @@
+#!/bin/bash
+# CFN Marketing Competitive Intel - Get Trending Topics Operation
+# Discover trending topics in industry
+
+set -euo pipefail
+
+# Default values
+REGION="global"
+LIMIT=10
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --industry)
+      INDUSTRY="$2"
+      shift 2
+      ;;
+    --region)
+      REGION="$2"
+      shift 2
+      ;;
+    --limit)
+      LIMIT="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '"$1"'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "${INDUSTRY:-}" ]]; then
+  echo '{"error": "Missing required parameter: --industry", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate industry
+case "$INDUSTRY" in
+  tech|finance|healthcare|retail|manufacturing|education|entertainment|real_estate|automotive|energy)
+    ;;
+  *)
+    echo '{"error": "Invalid industry: '"$INDUSTRY"'. Supported: tech, finance, healthcare, retail, manufacturing, education, entertainment, real_estate, automotive, energy", "code": "INVALID_INDUSTRY"}' >&2
+    exit 1
+    ;;
+esac
+
+# Validate region
+case "$REGION" in
+  global|us|uk|ca|au|de|fr|es|it|jp|cn)
+    ;;
+  *)
+    echo '{"error": "Invalid region: '"$REGION"'. Supported: global, us, uk, ca, au, de, fr, es, it, jp, cn", "code": "INVALID_REGION"}' >&2
+    exit 1
+    ;;
+esac
+
+# Validate limit
+if ! [[ "$LIMIT" =~ ^[0-9]+$ ]]; then
+  echo '{"error": "Limit must be a positive integer", "code": "INVALID_LIMIT"}' >&2
+  exit 1
+fi
+
+if (( LIMIT > 50 )); then
+  echo '{"error": "Limit cannot exceed 50", "code": "LIMIT_TOO_LARGE", "details": {"max": 50, "provided": '"$LIMIT"'}}' >&2
+  exit 1
+fi
+
+if (( LIMIT < 1 )); then
+  echo '{"error": "Limit must be at least 1", "code": "LIMIT_TOO_SMALL"}' >&2
+  exit 1
+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 industry "$INDUSTRY" \
+  --arg region "$REGION" \
+  --argjson limit "$LIMIT" \
+  '{
+    industry: $industry,
+    region: $region,
+    limit: $limit
+  }'
+)
+
+# 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/competitive-intel-trending-topics" 2>/dev/null || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle response
+case "$HTTP_CODE" in
+  200|201)
+    # Success - validate and format response
+    if ! echo "$BODY" | jq empty 2>/dev/null; then
+      # Mock response if API returns invalid JSON
+      echo "{
+        \"industry\": \"$INDUSTRY\",
+        \"region\": \"$REGION\",
+        \"topics\": [],
+        \"total_topics\": 0,
+        \"generated_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"
+      }"
+    else
+      echo "$BODY"
+    fi
+    exit 0
+    ;;
+  400)
+    echo '{"error": "Bad request - invalid 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
+    ;;
+  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-competitive-intel/operations/monitor-competitor.sh

@@ -0,0 +1,146 @@
+#!/bin/bash
+# CFN Marketing Competitive Intel - Monitor Competitor Operation
+# Track competitor activity including content, ads, and keywords
+
+set -euo pipefail
+
+# Default values
+ACTIVITY_TYPES="content,ads,keywords"
+LOOKBACK_DAYS=30
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --competitor)
+      COMPETITOR="$2"
+      shift 2
+      ;;
+    --activity-types)
+      ACTIVITY_TYPES="$2"
+      shift 2
+      ;;
+    --lookback-days)
+      LOOKBACK_DAYS="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '"$1"'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "${COMPETITOR:-}" ]]; then
+  echo '{"error": "Missing required parameter: --competitor", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate competitor domain format (basic validation)
+if [[ ! "$COMPETITOR" =~ ^[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z]{2,})+$ ]]; then
+  echo '{"error": "Invalid domain format for --competitor", "code": "INVALID_DOMAIN"}' >&2
+  exit 1
+fi
+
+# Validate activity types
+IFS=',' read -ra TYPE_ARRAY <<< "$ACTIVITY_TYPES"
+for type in "${TYPE_ARRAY[@]}"; do
+  case "$type" in
+    content|ads|keywords)
+      ;;
+    *)
+      echo '{"error": "Invalid activity type: '"$type"'. Supported: content, ads, keywords", "code": "INVALID_ACTIVITY_TYPE"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate lookback days
+if ! [[ "$LOOKBACK_DAYS" =~ ^[0-9]+$ ]]; then
+  echo '{"error": "Lookback days must be a positive integer", "code": "INVALID_LOOKBACK"}' >&2
+  exit 1
+fi
+
+if (( LOOKBACK_DAYS > 90 )); then
+  echo '{"error": "Lookback days cannot exceed 90", "code": "LOOKBACK_TOO_LARGE", "details": {"max": 90, "provided": '"$LOOKBACK_DAYS"'}}' >&2
+  exit 1
+fi
+
+if (( LOOKBACK_DAYS < 1 )); then
+  echo '{"error": "Lookback days must be at least 1", "code": "LOOKBACK_TOO_SMALL"}' >&2
+  exit 1
+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 competitor "$COMPETITOR" \
+  --arg types "$ACTIVITY_TYPES" \
+  --argjson days "$LOOKBACK_DAYS" \
+  '{
+    competitor: $competitor,
+    activity_types: ($types | split(",")),
+    lookback_days: $days
+  }'
+)
+
+# 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/competitive-intel-monitor-competitor" 2>/dev/null || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle response
+case "$HTTP_CODE" in
+  200|201)
+    # Success - validate and format response
+    if ! echo "$BODY" | jq empty 2>/dev/null; then
+      # Mock response if API returns invalid JSON
+      echo "{
+        \"competitor\": \"$COMPETITOR\",
+        \"activity\": {},
+        \"lookback_period\": \"$LOOKBACK_DAYS days\",
+        \"activity_types\": $(echo "$ACTIVITY_TYPES" | jq -R 'split(",")'),
+        \"checked_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"
+      }"
+    else
+      echo "$BODY"
+    fi
+    exit 0
+    ;;
+  400)
+    echo '{"error": "Bad request - invalid 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
+    ;;
+  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-competitive-intel/operations/search-brand-mentions.sh

@@ -0,0 +1,167 @@
+#!/bin/bash
+# CFN Marketing Competitive Intel - Search Brand Mentions Operation
+# Search for brand mentions across multiple sources
+
+set -euo pipefail
+
+# Default values
+SOURCES="twitter,reddit,news,blogs"
+DATE_FROM=$(date -d '7 days ago' +%Y-%m-%d 2>/dev/null || date -v-7d +%Y-%m-%d)
+DATE_TO=$(date +%Y-%m-%d)
+SENTIMENT="all"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --brand)
+      BRAND="$2"
+      shift 2
+      ;;
+    --sources)
+      SOURCES="$2"
+      shift 2
+      ;;
+    --date-from)
+      DATE_FROM="$2"
+      shift 2
+      ;;
+    --date-to)
+      DATE_TO="$2"
+      shift 2
+      ;;
+    --sentiment)
+      SENTIMENT="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '"$1"'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "${BRAND:-}" ]]; then
+  echo '{"error": "Missing required parameter: --brand", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate sources
+IFS=',' read -ra SOURCE_ARRAY <<< "$SOURCES"
+for source in "${SOURCE_ARRAY[@]}"; do
+  case "$source" in
+    twitter|reddit|news|blogs)
+      ;;
+    *)
+      echo '{"error": "Invalid source: '"$source"'. Supported: twitter, reddit, news, blogs", "code": "INVALID_SOURCE"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate sentiment
+case "$SENTIMENT" in
+  all|positive|negative|neutral)
+    ;;
+  *)
+    echo '{"error": "Invalid sentiment: '"$SENTIMENT"'. Supported: all, positive, negative, neutral", "code": "INVALID_SENTIMENT"}' >&2
+    exit 1
+    ;;
+esac
+
+# Validate date format
+if ! date -d "$DATE_FROM" +%Y-%m-%d &>/dev/null && ! date -j -f "%Y-%m-%d" "$DATE_FROM" &>/dev/null; then
+  echo '{"error": "Invalid date format for --date-from. Use YYYY-MM-DD", "code": "INVALID_DATE"}' >&2
+  exit 1
+fi
+
+if ! date -d "$DATE_TO" +%Y-%m-%d &>/dev/null && ! date -j -f "%Y-%m-%d" "$DATE_TO" &>/dev/null; then
+  echo '{"error": "Invalid date format for --date-to. Use YYYY-MM-DD", "code": "INVALID_DATE"}' >&2
+  exit 1
+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 brand "$BRAND" \
+  --arg sources "$SOURCES" \
+  --arg from "$DATE_FROM" \
+  --arg to "$DATE_TO" \
+  --arg sentiment "$SENTIMENT" \
+  '{
+    brand: $brand,
+    sources: ($sources | split(",")),
+    date_from: $from,
+    date_to: $to,
+    sentiment: $sentiment
+  }'
+)
+
+# 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/competitive-intel-search-mentions" 2>/dev/null || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle response
+case "$HTTP_CODE" in
+  200|201)
+    # Success - validate and format response
+    if ! echo "$BODY" | jq empty 2>/dev/null; then
+      # Mock response if API returns invalid JSON
+      echo "{
+        \"brand\": \"$BRAND\",
+        \"mentions\": [],
+        \"total_mentions\": 0,
+        \"sentiment_breakdown\": {
+          \"positive\": 0,
+          \"negative\": 0,
+          \"neutral\": 0
+        },
+        \"date_range\": {
+          \"from\": \"$DATE_FROM\",
+          \"to\": \"$DATE_TO\"
+        },
+        \"sources\": $(echo "$SOURCES" | jq -R 'split(",")')
+      }"
+    else
+      echo "$BODY"
+    fi
+    exit 0
+    ;;
+  400)
+    echo '{"error": "Bad request - invalid 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
+    ;;
+  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-crm-contacts/SKILL.md

@@ -0,0 +1,116 @@
+# CFN Marketing CRM Contacts Skill
+
+## Purpose
+Manage CRM contacts through n8n workflow integration. Create, update, retrieve contacts and manage contact segments.
+
+## Operations
+
+### 1. create-contact.sh
+Create a new contact in CRM.
+
+**Parameters:**
+- `--email` (required): Contact email address
+- `--first-name` (optional): First name
+- `--last-name` (optional): Last name
+- `--company` (optional): Company name
+- `--phone` (optional): Phone number
+- `--custom-fields` (optional): JSON string of custom fields
+
+**Example:**
+```bash
+./operations/create-contact.sh \
+  --email "john@example.com" \
+  --first-name "John" \
+  --last-name "Doe" \
+  --company "Acme Corp" \
+  --phone "+1-555-0100" \
+  --custom-fields '{"industry":"Tech","size":"50-200"}'
+```
+
+### 2. update-contact.sh
+Update existing contact information.
+
+**Parameters:**
+- `--contact-id` (required): Contact identifier
+- `--email` (optional): Updated email address
+- `--first-name` (optional): Updated first name
+- `--last-name` (optional): Updated last name
+- `--company` (optional): Updated company name
+- `--phone` (optional): Updated phone number
+- `--custom-fields` (optional): JSON string of custom fields to update
+
+**Example:**
+```bash
+./operations/update-contact.sh \
+  --contact-id "contact-123" \
+  --company "New Company Inc" \
+  --custom-fields '{"industry":"Finance"}'
+```
+
+### 3. get-contact.sh
+Retrieve contact information.
+
+**Parameters:**
+- `--contact-id` (optional): Contact identifier
+- `--email` (optional): Contact email (alternative to contact-id)
+- `--include-history` (optional): Include interaction history (true/false)
+
+**Example:**
+```bash
+./operations/get-contact.sh \
+  --contact-id "contact-123" \
+  --include-history true
+```
+
+### 4. add-to-segment.sh
+Add contact to a segment/list.
+
+**Parameters:**
+- `--contact-id` (required): Contact identifier
+- `--segment-id` (required): Segment/list identifier
+
+**Example:**
+```bash
+./operations/add-to-segment.sh \
+  --contact-id "contact-123" \
+  --segment-id "active-customers"
+```
+
+### 5. remove-from-segment.sh
+Remove contact from a segment/list.
+
+**Parameters:**
+- `--contact-id` (required): Contact identifier
+- `--segment-id` (required): Segment/list identifier
+
+**Example:**
+```bash
+./operations/remove-from-segment.sh \
+  --contact-id "contact-123" \
+  --segment-id "inactive-leads"
+```
+
+## 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-crm-contacts/operations/add-to-segment.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+set -euo pipefail
+
+# Add contact to 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/add-to-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