claude-flow-novice 2.18.6 → 2.18.7

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-press-distribution/operations/distribute-press-release.sh

@@ -1,94 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# distribute-press-release.sh - Distribute press release through wire services
-
-TITLE=""
-BODY=""
-OUTLETS=""
-EMBARGO_DATE=""
-CONTACT_NAME=""
-CONTACT_EMAIL=""
-
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    --title)
-      TITLE="$2"
-      shift 2
-      ;;
-    --body)
-      BODY="$2"
-      shift 2
-      ;;
-    --outlets)
-      OUTLETS="$2"
-      shift 2
-      ;;
-    --embargo-date)
-      EMBARGO_DATE="$2"
-      shift 2
-      ;;
-    --contact-name)
-      CONTACT_NAME="$2"
-      shift 2
-      ;;
-    --contact-email)
-      CONTACT_EMAIL="$2"
-      shift 2
-      ;;
-    *)
-      echo "Error: Unknown parameter $1" >&2
-      exit 1
-      ;;
-  esac
-done
-
-# Validate required parameters
-if [[ -z "$TITLE" ]] || [[ -z "$BODY" ]] || [[ -z "$OUTLETS" ]]; then
-  echo "Error: --title, --body, and --outlets are required" >&2
-  exit 1
-fi
-
-# Validate environment variables
-if [[ -z "${N8N_BASE_URL:-}" ]] || [[ -z "${N8N_API_KEY:-}" ]]; then
-  echo "Error: N8N_BASE_URL and N8N_API_KEY environment variables required" >&2
-  exit 1
-fi
-
-# Build JSON payload
-JSON_PAYLOAD=$(jq -n \
-  --arg title "$TITLE" \
-  --arg body "$BODY" \
-  --arg outlets "$OUTLETS" \
-  --arg embargo_date "$EMBARGO_DATE" \
-  --arg contact_name "$CONTACT_NAME" \
-  --arg contact_email "$CONTACT_EMAIL" \
-  '{
-    title: $title,
-    body: $body,
-    outlets: $outlets,
-    embargo_date: $embargo_date,
-    contact_name: $contact_name,
-    contact_email: $contact_email
-  }')
-
-# Call n8n webhook
-RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
-  "${N8N_BASE_URL}/webhook/press-distribution-release" \
-  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
-  -H "Content-Type: application/json" \
-  -d "$JSON_PAYLOAD")
-
-HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
-BODY=$(echo "$RESPONSE" | sed '$d')
-
-if [[ "$HTTP_CODE" -ge 200 ]] && [[ "$HTTP_CODE" -lt 300 ]]; then
-  echo "$BODY"
-  exit 0
-elif [[ "$HTTP_CODE" -ge 400 ]] && [[ "$HTTP_CODE" -lt 500 ]]; then
-  echo "Error: Invalid request - $BODY" >&2
-  exit 3
-else
-  echo "Error: API error (HTTP $HTTP_CODE) - $BODY" >&2
-  exit 2
-fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-press-distribution/operations/get-distribution-status.sh

@@ -1,59 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# get-distribution-status.sh - Check press release distribution progress
-
-DISTRIBUTION_ID=""
-
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    --distribution-id)
-      DISTRIBUTION_ID="$2"
-      shift 2
-      ;;
-    *)
-      echo "Error: Unknown parameter $1" >&2
-      exit 1
-      ;;
-  esac
-done
-
-# Validate required parameters
-if [[ -z "$DISTRIBUTION_ID" ]]; then
-  echo "Error: --distribution-id is required" >&2
-  exit 1
-fi
-
-# Validate environment variables
-if [[ -z "${N8N_BASE_URL:-}" ]] || [[ -z "${N8N_API_KEY:-}" ]]; then
-  echo "Error: N8N_BASE_URL and N8N_API_KEY environment variables required" >&2
-  exit 1
-fi
-
-# Build JSON payload
-JSON_PAYLOAD=$(jq -n \
-  --arg distribution_id "$DISTRIBUTION_ID" \
-  '{
-    distribution_id: $distribution_id
-  }')
-
-# Call n8n webhook
-RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
-  "${N8N_BASE_URL}/webhook/press-distribution-status" \
-  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
-  -H "Content-Type: application/json" \
-  -d "$JSON_PAYLOAD")
-
-HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
-BODY=$(echo "$RESPONSE" | sed '$d')
-
-if [[ "$HTTP_CODE" -ge 200 ]] && [[ "$HTTP_CODE" -lt 300 ]]; then
-  echo "$BODY"
-  exit 0
-elif [[ "$HTTP_CODE" -ge 400 ]] && [[ "$HTTP_CODE" -lt 500 ]]; then
-  echo "Error: Invalid request - $BODY" >&2
-  exit 1
-else
-  echo "Error: API error (HTTP $HTTP_CODE) - $BODY" >&2
-  exit 2
-fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-press-distribution/operations/get-pickup-metrics.sh

@@ -1,72 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# get-pickup-metrics.sh - Retrieve detailed pickup metrics for distributed release
-
-DISTRIBUTION_ID=""
-TIMEFRAME="7d"
-
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    --distribution-id)
-      DISTRIBUTION_ID="$2"
-      shift 2
-      ;;
-    --timeframe)
-      TIMEFRAME="$2"
-      shift 2
-      ;;
-    *)
-      echo "Error: Unknown parameter $1" >&2
-      exit 1
-      ;;
-  esac
-done
-
-# Validate required parameters
-if [[ -z "$DISTRIBUTION_ID" ]]; then
-  echo "Error: --distribution-id is required" >&2
-  exit 1
-fi
-
-# Validate timeframe
-if [[ ! "$TIMEFRAME" =~ ^(24h|7d|30d)$ ]]; then
-  echo "Error: --timeframe must be 24h, 7d, or 30d" >&2
-  exit 1
-fi
-
-# Validate environment variables
-if [[ -z "${N8N_BASE_URL:-}" ]] || [[ -z "${N8N_API_KEY:-}" ]]; then
-  echo "Error: N8N_BASE_URL and N8N_API_KEY environment variables required" >&2
-  exit 1
-fi
-
-# Build JSON payload
-JSON_PAYLOAD=$(jq -n \
-  --arg distribution_id "$DISTRIBUTION_ID" \
-  --arg timeframe "$TIMEFRAME" \
-  '{
-    distribution_id: $distribution_id,
-    timeframe: $timeframe
-  }')
-
-# Call n8n webhook
-RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
-  "${N8N_BASE_URL}/webhook/press-distribution-metrics" \
-  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
-  -H "Content-Type: application/json" \
-  -d "$JSON_PAYLOAD")
-
-HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
-BODY=$(echo "$RESPONSE" | sed '$d')
-
-if [[ "$HTTP_CODE" -ge 200 ]] && [[ "$HTTP_CODE" -lt 300 ]]; then
-  echo "$BODY"
-  exit 0
-elif [[ "$HTTP_CODE" -ge 400 ]] && [[ "$HTTP_CODE" -lt 500 ]]; then
-  echo "Error: Invalid request - $BODY" >&2
-  exit 1
-else
-  echo "Error: API error (HTTP $HTTP_CODE) - $BODY" >&2
-  exit 2
-fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-press-distribution/operations/list-templates.sh

@@ -1,53 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# list-templates.sh - List available press release templates
-
-CATEGORY=""
-
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    --category)
-      CATEGORY="$2"
-      shift 2
-      ;;
-    *)
-      echo "Error: Unknown parameter $1" >&2
-      exit 1
-      ;;
-  esac
-done
-
-# Validate environment variables
-if [[ -z "${N8N_BASE_URL:-}" ]] || [[ -z "${N8N_API_KEY:-}" ]]; then
-  echo "Error: N8N_BASE_URL and N8N_API_KEY environment variables required" >&2
-  exit 1
-fi
-
-# Build JSON payload
-JSON_PAYLOAD=$(jq -n \
-  --arg category "$CATEGORY" \
-  '{
-    category: $category
-  }')
-
-# Call n8n webhook
-RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
-  "${N8N_BASE_URL}/webhook/press-distribution-templates" \
-  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
-  -H "Content-Type: application/json" \
-  -d "$JSON_PAYLOAD")
-
-HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
-BODY=$(echo "$RESPONSE" | sed '$d')
-
-if [[ "$HTTP_CODE" -ge 200 ]] && [[ "$HTTP_CODE" -lt 300 ]]; then
-  echo "$BODY"
-  exit 0
-elif [[ "$HTTP_CODE" -ge 400 ]] && [[ "$HTTP_CODE" -lt 500 ]]; then
-  echo "Error: Invalid request - $BODY" >&2
-  exit 1
-else
-  echo "Error: API error (HTTP $HTTP_CODE) - $BODY" >&2
-  exit 2
-fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-sms-campaigns/SKILL.md

@@ -1,429 +0,0 @@
-# CFN Marketing SMS Campaigns Skill
-
-**Version:** 1.0.0
-**Status:** Active
-**Owner:** CFN Marketing Team
-**Last Updated:** 2025-10-29
-
-## Overview
-
-Manages SMS marketing campaigns with TCPA compliance enforcement, opt-in verification, and Do Not Call registry integration using n8n workflow automation.
-
-## Purpose
-
-Enable compliant SMS marketing campaigns for lead nurturing, event notifications, and customer engagement while ensuring strict adherence to TCPA regulations and opt-in requirements.
-
-## Use Cases
-
-1. **Campaign Execution**: Send bulk SMS campaigns to opted-in recipients
-2. **Transactional SMS**: Send appointment confirmations, reminders, alerts
-3. **Opt-Out Management**: Process and honor opt-out requests immediately
-4. **Compliance Verification**: Check DNC registry and opt-in status before sending
-5. **Delivery Tracking**: Monitor SMS delivery status and failures
-
-## Legal Compliance (TCPA)
-
-### Mandatory Requirements
-
-1. **Prior Express Written Consent**: All recipients must opt-in before receiving marketing SMS
-2. **Clear Identification**: Messages must identify sender
-3. **Opt-Out Instructions**: Every message must include opt-out instructions
-4. **Immediate Opt-Out Processing**: Opt-out requests processed within seconds
-5. **Do Not Call Registry**: Check national DNC registry before sending
-6. **Time Restrictions**: No messages before 8 AM or after 9 PM recipient local time
-
-### Penalties for Non-Compliance
-
-- $500-$1,500 per violation (per message)
-- Class action lawsuits
-- FTC enforcement actions
-
-## Operations
-
-### 1. send-sms.sh
-
-**Purpose:** Send single SMS message with TCPA compliance checks
-
-**Parameters:**
-- `--phone` (required): Recipient phone number (E.164 format: +1XXXXXXXXXX)
-- `--message` (required): Message content (max 160 characters)
-- `--campaign-id` (optional): Associated campaign ID
-- `--sender-id` (optional): Sender identifier (default: company name)
-
-**TCPA Compliance Checks:**
-1. Verify recipient opted-in
-2. Check Do Not Call registry
-3. Validate time restrictions (8 AM - 9 PM local time)
-4. Include opt-out instructions
-
-**Exit Codes:**
-- 0: Success (SMS sent)
-- 1: Validation error (invalid phone, message too long)
-- 2: API error (network, authentication)
-- 3: Compliance violation (no opt-in, DNC registry, time restriction)
-
-**Example:**
-```bash
-./operations/send-sms.sh \
-  --phone "+12125551234" \
-  --message "Your demo is confirmed for Nov 5 at 2pm. Reply STOP to opt out." \
-  --campaign-id "camp_demo_reminders"
-```
-
-**Response:**
-```json
-{
-  "message_id": "sms_12345",
-  "phone": "+12125551234",
-  "status": "sent",
-  "sent_at": "2025-10-29T14:30:00Z",
-  "compliance_checks": {
-    "opt_in_verified": true,
-    "dnc_cleared": true,
-    "time_restriction_ok": true
-  }
-}
-```
-
-### 2. create-campaign.sh
-
-**Purpose:** Create SMS campaign configuration
-
-**Parameters:**
-- `--name` (required): Campaign name
-- `--message` (required): Message template (max 160 characters)
-- `--audience` (required): Target audience criteria (JSON)
-- `--sender-id` (optional): Sender identifier
-- `--schedule` (optional): ISO 8601 datetime for scheduling
-
-**Audience Criteria:**
-```json
-{
-  "segments": ["qualified_leads", "event_registrants"],
-  "exclude_segments": ["opted_out", "dnc"],
-  "min_qualification_score": 60
-}
-```
-
-**Exit Codes:**
-- 0: Success (campaign created)
-- 1: Validation error
-- 2: API error
-- 3: Compliance violation (invalid audience)
-
-**Example:**
-```bash
-./operations/create-campaign.sh \
-  --name "Q4 Product Launch" \
-  --message "New product launching Nov 15! Join our webinar. Reply STOP to opt out." \
-  --audience '{"segments":["qualified_leads"],"min_qualification_score":60}'
-```
-
-**Response:**
-```json
-{
-  "campaign_id": "camp_67890",
-  "name": "Q4 Product Launch",
-  "status": "draft",
-  "created_at": "2025-10-29T14:30:00Z",
-  "estimated_recipients": 1250,
-  "compliance_cleared": true
-}
-```
-
-### 3. schedule-campaign.sh
-
-**Purpose:** Schedule bulk SMS campaign
-
-**Parameters:**
-- `--campaign-id` (required): Campaign identifier
-- `--schedule-time` (required): ISO 8601 datetime
-- `--timezone` (required): IANA timezone (e.g., America/New_York)
-- `--batch-size` (optional): Messages per batch (default: 100)
-- `--batch-delay` (optional): Delay between batches in seconds (default: 60)
-
-**Throttling:** Automatic rate limiting to comply with carrier restrictions (1 message/second per number)
-
-**Exit Codes:**
-- 0: Success (campaign scheduled)
-- 1: Validation error
-- 2: API error
-- 3: Compliance violation (time restrictions)
-
-**Example:**
-```bash
-./operations/schedule-campaign.sh \
-  --campaign-id "camp_67890" \
-  --schedule-time "2025-11-01T10:00:00" \
-  --timezone "America/New_York" \
-  --batch-size 50
-```
-
-**Response:**
-```json
-{
-  "campaign_id": "camp_67890",
-  "scheduled_at": "2025-11-01T10:00:00-05:00",
-  "status": "scheduled",
-  "estimated_duration_minutes": 25,
-  "batch_count": 25,
-  "total_recipients": 1250
-}
-```
-
-### 4. get-delivery-status.sh
-
-**Purpose:** Check SMS delivery status
-
-**Parameters:**
-- `--message-id` (required): Message identifier
-- `--phone` (optional): Recipient phone number (for filtering)
-- `--campaign-id` (optional): Campaign identifier (for bulk status)
-
-**Exit Codes:**
-- 0: Success (status retrieved)
-- 1: Validation error
-- 2: API error
-- 3: Message not found
-
-**Example:**
-```bash
-./operations/get-delivery-status.sh \
-  --message-id "sms_12345"
-```
-
-**Response:**
-```json
-{
-  "message_id": "sms_12345",
-  "phone": "+12125551234",
-  "status": "delivered",
-  "delivered_at": "2025-10-29T14:30:15Z",
-  "carrier": "T-Mobile",
-  "error": null
-}
-```
-
-**Status Values:**
-- `queued`: Message accepted, pending delivery
-- `sent`: Sent to carrier
-- `delivered`: Confirmed delivered to device
-- `failed`: Delivery failed (invalid number, carrier error)
-- `undelivered`: Temporary failure (device off, no signal)
-
-### 5. opt-out.sh
-
-**Purpose:** Process opt-out request (CRITICAL - must execute within seconds)
-
-**Parameters:**
-- `--phone` (required): Phone number to opt out
-- `--source` (optional): Opt-out source (inbound_sms|web|manual)
-- `--reason` (optional): Opt-out reason
-
-**TCPA Compliance:**
-- Immediate execution (<5 seconds)
-- Persist to Redis and database
-- No further messages allowed (ever)
-- Confirmation message sent
-
-**Exit Codes:**
-- 0: Success (opted out)
-- 1: Validation error
-- 2: API error
-- 3: Already opted out
-
-**Example:**
-```bash
-./operations/opt-out.sh \
-  --phone "+12125551234" \
-  --source "inbound_sms" \
-  --reason "STOP keyword received"
-```
-
-**Response:**
-```json
-{
-  "phone": "+12125551234",
-  "opted_out": true,
-  "opted_out_at": "2025-10-29T14:30:00Z",
-  "source": "inbound_sms",
-  "confirmation_sent": true,
-  "message": "You have been unsubscribed. No further messages will be sent."
-}
-```
-
-## Environment Variables
-
-```bash
-# Required
-N8N_BASE_URL=https://n8n.example.com
-N8N_API_KEY=n8n_api_key_xxx
-
-# SMS Provider (Twilio or Plivo)
-TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxx
-TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxx
-TWILIO_PHONE_NUMBER=+12125551000
-
-# Alternative: Plivo
-PLIVO_AUTH_ID=MAxxxxxxxxxxxxxx
-PLIVO_AUTH_TOKEN=xxxxxxxxxxxxxxxx
-PLIVO_PHONE_NUMBER=+12125551000
-
-# Redis for opt-in/opt-out tracking
-REDIS_HOST=localhost
-REDIS_PORT=6379
-REDIS_PASSWORD=redis_password
-```
-
-## TCPA Compliance Implementation
-
-### Opt-In Verification
-
-```bash
-# Every send operation MUST check opt-in status
-OPT_IN=$(redis-cli GET "sms:opt_in:$PHONE")
-if [[ "$OPT_IN" != "true" ]]; then
-  echo '{"error": "Recipient has not opted-in (TCPA violation)", "code": "NO_OPT_IN"}' >&2
-  exit 3
-fi
-```
-
-### Do Not Call Registry
-
-```bash
-# Check DNC registry before sending
-DNC=$(redis-cli GET "sms:dnc:$PHONE")
-if [[ "$DNC" == "true" ]]; then
-  echo '{"error": "Phone number on DNC registry", "code": "DNC_VIOLATION"}' >&2
-  exit 3
-fi
-```
-
-### Time Restrictions
-
-```bash
-# Validate time restrictions (8 AM - 9 PM recipient local time)
-CURRENT_HOUR=$(TZ="$RECIPIENT_TIMEZONE" date +%H)
-if [[ "$CURRENT_HOUR" -lt 8 ]] || [[ "$CURRENT_HOUR" -ge 21 ]]; then
-  echo '{"error": "Time restriction violation (8 AM - 9 PM)", "code": "TIME_RESTRICTION"}' >&2
-  exit 3
-fi
-```
-
-### Immediate Opt-Out Processing
-
-```bash
-# opt-out.sh - CRITICAL compliance requirement
-redis-cli SET "sms:opt_in:$PHONE" "false"
-redis-cli SET "sms:dnc:$PHONE" "true"
-redis-cli SADD "sms:global_opt_out" "$PHONE"
-
-# Persist to database (async)
-curl -X POST "${N8N_BASE_URL}/webhook/sms/opt-out" \
-  -H "Content-Type: application/json" \
-  -d '{"phone":"'"$PHONE"'","opted_out_at":"'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'"}'
-```
-
-## Performance Requirements
-
-- **Single SMS Send:** <3 seconds
-- **Opt-In Verification:** <100ms (Redis lookup)
-- **Opt-Out Processing:** <5 seconds (legal requirement)
-- **Campaign Creation:** <2 seconds
-- **Delivery Status:** <1 second
-
-## Error Handling
-
-All operations return standardized JSON error responses:
-
-```json
-{
-  "error": "Recipient has not opted-in (TCPA violation)",
-  "code": "NO_OPT_IN",
-  "timestamp": "2025-10-29T14:30:00Z",
-  "phone": "+12125551234",
-  "severity": "critical"
-}
-```
-
-## Monitoring & Alerts
-
-### Critical Alerts (Immediate Response)
-
-- Compliance violations detected
-- Opt-out processing failures
-- DNC registry check failures
-
-### Warning Alerts (Review Within 1 Hour)
-
-- Delivery rate below 95%
-- High bounce rate (>5%)
-- API rate limiting
-
-### Metrics Tracking
-
-- Opt-in rate
-- Opt-out rate
-- Delivery rate
-- Response rate
-- Compliance violation rate (target: 0%)
-
-## Integration Points
-
-- **n8n Workflows:** SMS webhook triggers
-- **CRM Systems:** Lead qualification sync
-- **Analytics:** Campaign performance tracking
-- **DNC Registry:** Real-time compliance checks
-- **Redis:** Opt-in/opt-out state management
-
-## Testing
-
-```bash
-# Test single SMS send (with mock opt-in)
-redis-cli SET "sms:opt_in:+11234567890" "true"
-./operations/send-sms.sh \
-  --phone "+11234567890" \
-  --message "Test message - Reply STOP to opt out"
-
-# Test compliance violation (no opt-in)
-redis-cli DEL "sms:opt_in:+11234567890"
-./operations/send-sms.sh \
-  --phone "+11234567890" \
-  --message "Test message"
-# Expected: Exit code 3, error: "NO_OPT_IN"
-
-# Test opt-out processing
-./operations/opt-out.sh \
-  --phone "+11234567890" \
-  --source "manual"
-# Verify: redis-cli GET "sms:opt_in:+11234567890" returns "false"
-
-# Test campaign creation
-./operations/create-campaign.sh \
-  --name "Test Campaign" \
-  --message "Test campaign message. Reply STOP to opt out." \
-  --audience '{"segments":["test_segment"]}'
-```
-
-## Maintenance
-
-- **Opt-Out List Backup:** Daily backup to S3
-- **DNC Registry Sync:** Weekly sync from national registry
-- **Carrier Updates:** Monitor carrier policy changes
-- **Performance Review:** Monthly campaign performance analysis
-- **Compliance Audit:** Quarterly TCPA compliance audit
-
-## Related Skills
-
-- `cfn-marketing-chatbot-conversations`: Lead qualification for SMS targeting
-- `cfn-marketing-email-campaigns`: Multi-channel campaign coordination
-- `cfn-marketing-crm-integration`: Contact management and opt-in tracking
-- `cfn-marketing-analytics-reporting`: SMS campaign analytics
-
-## References
-
-- [TCPA Compliance Guide](https://www.fcc.gov/general/telemarketing-and-robocalls)
-- [Twilio SMS Best Practices](https://www.twilio.com/docs/sms/best-practices)
-- [Plivo SMS API](https://www.plivo.com/docs/sms/)
-- [National Do Not Call Registry](https://www.donotcall.gov/)
-- [n8n Twilio Node Documentation](https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.twilio/)