crewly 1.4.60 → 1.4.62

package/config/skills/agent/marketing/weekly-content-planning/execute.sh

@@ -0,0 +1,202 @@
+#!/bin/bash
+# Weekly Content Planning — generates a weekly content calendar with 5-7 posts
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"businessName\":\"...\",\"industry\":\"...\",\"platforms\":[\"x\",\"linkedin\"],\"weekStartDate\":\"YYYY-MM-DD\"}'"
+
+# Parse parameters
+BUSINESS_NAME=$(echo "$INPUT" | jq -r '.businessName // empty')
+INDUSTRY=$(echo "$INPUT" | jq -r '.industry // empty')
+PLATFORMS=$(echo "$INPUT" | jq -r '.platforms // empty')
+CONTENT_MIX=$(echo "$INPUT" | jq -r '.contentMix // "{\"educational\":40,\"engagement\":30,\"promotional\":20,\"community\":10}"')
+WEEK_START=$(echo "$INPUT" | jq -r '.weekStartDate // empty')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+POST_COUNT=$(echo "$INPUT" | jq -r '.postCount // "5"')
+
+require_param "businessName" "$BUSINESS_NAME"
+require_param "industry" "$INDUSTRY"
+require_param "platforms" "$PLATFORMS"
+require_param "weekStartDate" "$WEEK_START"
+
+# Validate platforms is a JSON array
+if ! echo "$PLATFORMS" | jq -e 'type == "array"' >/dev/null 2>&1; then
+  error_exit "platforms must be a JSON array, e.g. [\"x\",\"linkedin\"]"
+fi
+
+PLATFORM_COUNT=$(echo "$PLATFORMS" | jq 'length')
+if [ "$PLATFORM_COUNT" -eq 0 ]; then
+  error_exit "platforms array must not be empty"
+fi
+
+# Validate content mix
+if ! echo "$CONTENT_MIX" | jq empty 2>/dev/null; then
+  CONTENT_MIX='{"educational":40,"engagement":30,"promotional":20,"community":10}'
+fi
+
+# Path to content-calendar skill
+CALENDAR_SKILL="${SCRIPT_DIR}/../../content-calendar/execute.sh"
+if [ ! -f "$CALENDAR_SKILL" ]; then
+  error_exit "content-calendar skill not found at ${CALENDAR_SKILL}"
+fi
+
+# Helper: get topic by category
+get_topic() {
+  local cat="$1"
+  case "$cat" in
+    educational) echo "Industry insight: ${INDUSTRY} trends and best practices" ;;
+    engagement) echo "Community question: What matters most to our ${INDUSTRY} audience" ;;
+    promotional) echo "Product spotlight: How ${BUSINESS_NAME} solves ${INDUSTRY} challenges" ;;
+    community) echo "Behind the scenes: A day at ${BUSINESS_NAME}" ;;
+    *) echo "Content for ${BUSINESS_NAME}" ;;
+  esac
+}
+
+# Compute content mix distribution
+EDU_PCT=$(echo "$CONTENT_MIX" | jq -r '.educational // 40')
+ENG_PCT=$(echo "$CONTENT_MIX" | jq -r '.engagement // 30')
+PROMO_PCT=$(echo "$CONTENT_MIX" | jq -r '.promotional // 20')
+COMM_PCT=$(echo "$CONTENT_MIX" | jq -r '.community // 10')
+
+# Calculate post count per category
+TOTAL_PCT=$((EDU_PCT + ENG_PCT + PROMO_PCT + COMM_PCT))
+if [ "$TOTAL_PCT" -eq 0 ]; then
+  TOTAL_PCT=100
+fi
+
+EDU_COUNT=$(( (POST_COUNT * EDU_PCT + TOTAL_PCT - 1) / TOTAL_PCT ))
+ENG_COUNT=$(( (POST_COUNT * ENG_PCT + TOTAL_PCT - 1) / TOTAL_PCT ))
+PROMO_COUNT=$(( (POST_COUNT * PROMO_PCT + TOTAL_PCT - 1) / TOTAL_PCT ))
+COMM_COUNT=$(( POST_COUNT - EDU_COUNT - ENG_COUNT - PROMO_COUNT ))
+[ "$COMM_COUNT" -lt 0 ] && COMM_COUNT=0
+
+# Build ordered category list as space-separated string
+CATEGORIES=""
+i=0; while [ "$i" -lt "$EDU_COUNT" ]; do CATEGORIES="$CATEGORIES educational"; i=$((i+1)); done
+i=0; while [ "$i" -lt "$ENG_COUNT" ]; do CATEGORIES="$CATEGORIES engagement"; i=$((i+1)); done
+i=0; while [ "$i" -lt "$PROMO_COUNT" ]; do CATEGORIES="$CATEGORIES promotional"; i=$((i+1)); done
+i=0; while [ "$i" -lt "$COMM_COUNT" ]; do CATEGORIES="$CATEGORIES community"; i=$((i+1)); done
+
+# Trim whitespace and convert to array-like processing
+CATEGORIES=$(echo "$CATEGORIES" | xargs)
+
+# Trim to POST_COUNT
+CAT_ARRAY=""
+COUNT=0
+for CAT in $CATEGORIES; do
+  if [ "$COUNT" -ge "$POST_COUNT" ]; then break; fi
+  CAT_ARRAY="$CAT_ARRAY $CAT"
+  COUNT=$((COUNT + 1))
+done
+CAT_ARRAY=$(echo "$CAT_ARRAY" | xargs)
+TOTAL_ENTRIES=$COUNT
+
+DAY_NAMES="Mon Tue Wed Thu Fri Sat Sun"
+
+# Generate entries
+ENTRIES="[]"
+MARKDOWN_TABLE="| Day | Platform | Type | Category | Topic | Status |\n|-----|----------|------|----------|-------|--------|\n"
+
+INDEX=0
+for CATEGORY in $CAT_ARRAY; do
+  # Cycle through platforms
+  PLATFORM_INDEX=$((INDEX % PLATFORM_COUNT))
+  PLATFORM_RAW=$(echo "$PLATFORMS" | jq -r ".[$PLATFORM_INDEX]")
+
+  # Normalize platform display names to calendar skill identifiers
+  case "$(echo "$PLATFORM_RAW" | tr '[:upper:]' '[:lower:]')" in
+    "x (twitter)"|"x"|"twitter") PLATFORM="x" ;;
+    "linkedin")                  PLATFORM="linkedin" ;;
+    "instagram")                 PLATFORM="instagram" ;;
+    "facebook")                  PLATFORM="facebook" ;;
+    "youtube")                   PLATFORM="youtube" ;;
+    "xiaohongshu"|"小红书")       PLATFORM="xiaohongshu" ;;
+    "substack")                  PLATFORM="substack" ;;
+    "reddit")                    PLATFORM="reddit" ;;
+    "github")                    PLATFORM="github" ;;
+    *) PLATFORM=$(echo "$PLATFORM_RAW" | tr '[:upper:]' '[:lower:]') ;;
+  esac
+
+  # Calculate the date offset (spread across the week)
+  DAY_OFFSET=$((INDEX * 7 / TOTAL_ENTRIES))
+
+  # Calculate scheduled date
+  if date -v+${DAY_OFFSET}d +%Y-%m-%d 2>/dev/null >/dev/null; then
+    # macOS: -v flag must come before -f
+    SCHED_DATE=$(date -j -v+${DAY_OFFSET}d -f "%Y-%m-%d" "$WEEK_START" +%Y-%m-%d 2>/dev/null || echo "$WEEK_START")
+  else
+    # GNU date
+    SCHED_DATE=$(date -d "$WEEK_START + $DAY_OFFSET days" +%Y-%m-%d 2>/dev/null || echo "$WEEK_START")
+  fi
+
+  # Set content type based on platform
+  case "$PLATFORM" in
+    x) CONTENT_TYPE="post" ;;
+    linkedin) CONTENT_TYPE="post" ;;
+    instagram) CONTENT_TYPE="image-text" ;;
+    youtube) CONTENT_TYPE="video" ;;
+    substack) CONTENT_TYPE="newsletter" ;;
+    *) CONTENT_TYPE="post" ;;
+  esac
+
+  TOPIC=$(get_topic "$CATEGORY")
+  TITLE="${BUSINESS_NAME} — ${CATEGORY} content for ${PLATFORM} (Week of ${WEEK_START})"
+
+  # Get day name from offset
+  DAY_NAME=$(echo "$DAY_NAMES" | cut -d' ' -f$((DAY_OFFSET + 1)))
+
+  # Add to content calendar via skill
+  ADD_INPUT=$(jq -n \
+    --arg action "add" \
+    --arg title "$TITLE" \
+    --arg platform "$PLATFORM" \
+    --arg type "$CONTENT_TYPE" \
+    --arg scheduledDate "$SCHED_DATE" \
+    --arg status "draft" \
+    --arg topic "$TOPIC" \
+    --arg notes "Category: ${CATEGORY}. Auto-generated by weekly-content-planning skill." \
+    --arg projectPath "$PROJECT_PATH" \
+    '{action:$action,title:$title,platform:$platform,type:$type,scheduledDate:$scheduledDate,status:$status,topic:$topic,notes:$notes,projectPath:$projectPath}')
+
+  RESULT=$(bash "$CALENDAR_SKILL" "$ADD_INPUT" 2>/dev/null || echo '{"success":false}')
+
+  ENTRY_ID=$(echo "$RESULT" | jq -r '.entry.id // "unknown"')
+
+  # Build entry object
+  ENTRY=$(jq -n \
+    --arg id "$ENTRY_ID" \
+    --arg day "$DAY_NAME" \
+    --arg platform "$PLATFORM" \
+    --arg type "$CONTENT_TYPE" \
+    --arg category "$CATEGORY" \
+    --arg topic "$TOPIC" \
+    --arg title "$TITLE" \
+    --arg scheduledDate "$SCHED_DATE" \
+    --arg status "draft" \
+    '{id:$id,day:$day,platform:$platform,type:$type,category:$category,topic:$topic,title:$title,scheduledDate:$scheduledDate,status:$status}')
+
+  ENTRIES=$(echo "$ENTRIES" | jq --argjson e "$ENTRY" '. += [$e]')
+  MARKDOWN_TABLE="${MARKDOWN_TABLE}| ${DAY_NAME} | ${PLATFORM} | ${CONTENT_TYPE} | ${CATEGORY} | ${TOPIC} | draft |\n"
+
+  INDEX=$((INDEX + 1))
+done
+
+ENTRY_COUNT=$(echo "$ENTRIES" | jq 'length')
+
+# Output result
+jq -n \
+  --arg businessName "$BUSINESS_NAME" \
+  --arg weekStart "$WEEK_START" \
+  --argjson entries "$ENTRIES" \
+  --argjson entryCount "$ENTRY_COUNT" \
+  --arg calendar "$(echo -e "$MARKDOWN_TABLE")" \
+  '{
+    "success": true,
+    "businessName": $businessName,
+    "weekStartDate": $weekStart,
+    "entryCount": $entryCount,
+    "entries": $entries,
+    "calendar": $calendar
+  }'

package/config/skills/agent/marketing/weekly-content-planning/execute.test.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+# Tests for weekly-content-planning skill
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXECUTE="${SCRIPT_DIR}/execute.sh"
+TEST_PROJECT=$(mktemp -d)
+PASS=0
+FAIL=0
+
+cleanup() {
+  rm -rf "$TEST_PROJECT"
+}
+trap cleanup EXIT
+
+assert_eq() {
+  local test_name="$1" expected="$2" actual="$3"
+  if [ "$expected" = "$actual" ]; then
+    echo "  ✓ ${test_name}"
+    PASS=$((PASS + 1))
+  else
+    echo "  ✗ ${test_name}: expected '${expected}', got '${actual}'"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+assert_true() {
+  local test_name="$1" value="$2"
+  if [ "$value" = "true" ]; then
+    echo "  ✓ ${test_name}"
+    PASS=$((PASS + 1))
+  else
+    echo "  ✗ ${test_name}: expected true, got '${value}'"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+assert_gte() {
+  local test_name="$1" expected="$2" actual="$3"
+  if [ "$actual" -ge "$expected" ] 2>/dev/null; then
+    echo "  ✓ ${test_name}"
+    PASS=$((PASS + 1))
+  else
+    echo "  ✗ ${test_name}: expected >= ${expected}, got '${actual}'"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+echo "=== Weekly Content Planning Skill Tests ==="
+echo ""
+
+# ─────────────────────────────────────────────
+# Test 1: Missing required parameters
+# ─────────────────────────────────────────────
+echo "Test 1: Missing required parameters"
+RESULT=$(bash "$EXECUTE" '{}' 2>&1 || true)
+HAS_ERROR=$(echo "$RESULT" | jq -r '.error // empty' 2>/dev/null || echo "")
+assert_true "exits with error on missing params" "$([ -n "$HAS_ERROR" ] && echo true || echo false)"
+
+# ─────────────────────────────────────────────
+# Test 2: Basic generation with 2 platforms
+# ─────────────────────────────────────────────
+echo "Test 2: Basic generation with 2 platforms"
+RESULT=$(bash "$EXECUTE" "{
+  \"businessName\": \"TestCorp\",
+  \"industry\": \"technology\",
+  \"platforms\": [\"x\", \"linkedin\"],
+  \"weekStartDate\": \"2026-03-23\",
+  \"projectPath\": \"${TEST_PROJECT}\",
+  \"postCount\": \"5\"
+}")
+
+assert_true "returns success" "$(echo "$RESULT" | jq -r '.success')"
+assert_eq "businessName matches" "TestCorp" "$(echo "$RESULT" | jq -r '.businessName')"
+assert_eq "weekStartDate matches" "2026-03-23" "$(echo "$RESULT" | jq -r '.weekStartDate')"
+assert_eq "generates 5 entries" "5" "$(echo "$RESULT" | jq -r '.entryCount')"
+assert_true "has calendar markdown" "$(echo "$RESULT" | jq -r '.calendar' | grep -q 'Platform' && echo true || echo false)"
+
+# Verify entries are written to calendar.json
+CALENDAR_PATH="${TEST_PROJECT}/.crewly/content/calendar.json"
+assert_true "calendar file created" "$([ -f "$CALENDAR_PATH" ] && echo true || echo false)"
+CALENDAR_ENTRIES=$(jq '.entries | length' "$CALENDAR_PATH")
+assert_eq "calendar has 5 entries" "5" "$CALENDAR_ENTRIES"
+
+# ─────────────────────────────────────────────
+# Test 3: Single platform
+# ─────────────────────────────────────────────
+echo "Test 3: Single platform"
+TEST_PROJECT_2=$(mktemp -d)
+RESULT=$(bash "$EXECUTE" "{
+  \"businessName\": \"Solo\",
+  \"industry\": \"marketing\",
+  \"platforms\": [\"x\"],
+  \"weekStartDate\": \"2026-04-01\",
+  \"projectPath\": \"${TEST_PROJECT_2}\",
+  \"postCount\": \"3\"
+}")
+
+assert_true "returns success" "$(echo "$RESULT" | jq -r '.success')"
+assert_eq "generates 3 entries" "3" "$(echo "$RESULT" | jq -r '.entryCount')"
+
+# All entries should be on x platform
+ALL_X=$(echo "$RESULT" | jq '[.entries[] | select(.platform == "x")] | length')
+assert_eq "all entries on x platform" "3" "$ALL_X"
+rm -rf "$TEST_PROJECT_2"
+
+# ─────────────────────────────────────────────
+# Test 4: Invalid platforms format
+# ─────────────────────────────────────────────
+echo "Test 4: Invalid platforms format"
+RESULT=$(bash "$EXECUTE" '{
+  "businessName": "Test",
+  "industry": "tech",
+  "platforms": "not-an-array",
+  "weekStartDate": "2026-03-23"
+}' 2>&1 || true)
+HAS_ERROR=$(echo "$RESULT" | jq -r '.error // empty' 2>/dev/null || echo "")
+assert_true "errors on non-array platforms" "$([ -n "$HAS_ERROR" ] && echo true || echo false)"
+
+# ─────────────────────────────────────────────
+# Test 5: Entries have correct structure
+# ─────────────────────────────────────────────
+echo "Test 5: Entry structure validation"
+TEST_PROJECT_5=$(mktemp -d)
+RESULT=$(bash "$EXECUTE" "{
+  \"businessName\": \"StructTest\",
+  \"industry\": \"ai\",
+  \"platforms\": [\"linkedin\"],
+  \"weekStartDate\": \"2026-03-23\",
+  \"projectPath\": \"${TEST_PROJECT_5}\",
+  \"postCount\": \"2\"
+}")
+
+FIRST_ENTRY=$(echo "$RESULT" | jq '.entries[0]')
+assert_true "entry has id" "$(echo "$FIRST_ENTRY" | jq -r 'has("id")' )"
+assert_true "entry has platform" "$(echo "$FIRST_ENTRY" | jq -r 'has("platform")')"
+assert_true "entry has category" "$(echo "$FIRST_ENTRY" | jq -r 'has("category")')"
+assert_true "entry has topic" "$(echo "$FIRST_ENTRY" | jq -r 'has("topic")')"
+assert_true "entry has scheduledDate" "$(echo "$FIRST_ENTRY" | jq -r 'has("scheduledDate")')"
+assert_eq "entry status is draft" "draft" "$(echo "$FIRST_ENTRY" | jq -r '.status')"
+rm -rf "$TEST_PROJECT_5"
+
+# ─────────────────────────────────────────────
+# Summary
+# ─────────────────────────────────────────────
+echo ""
+echo "=== Results: ${PASS} passed, ${FAIL} failed ==="
+
+if [ "$FAIL" -gt 0 ]; then
+  exit 1
+fi

package/config/skills/agent/marketing/weekly-marketing-report/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: weekly-marketing-report
+description: Generates a structured weekly marketing performance report by reading content calendar data and summarizing posts by platform, status, and completion rate.
+version: 1.0.0
+category: marketing
+skillType: claude-skill
+assignableRoles:
+  - analyst
+triggers:
+  - weekly report
+  - marketing report
+  - performance report
+  - analytics report
+tags:
+  - marketing
+  - analytics
+  - report
+  - weekly
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
+# Weekly Marketing Report
+
+Generates a structured weekly marketing performance report by reading content calendar data.
+
+## Input Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `projectPath` | No | Project path to find calendar data (default: `~/.crewly`) |
+| `weekEndDate` | Yes | End date of the reporting week in `YYYY-MM-DD` format |
+| `businessName` | Yes | Name of the business |
+| `calendarPath` | No | Custom path to calendar.json (overrides default) |
+
+## Example
+
+```bash
+bash execute.sh '{"projectPath":"/path/to/project","weekEndDate":"2026-03-29","businessName":"Acme AI"}'
+```
+
+## Output
+
+Returns JSON with:
+- `success`: boolean
+- `report`: structured report object with summary, platformBreakdown, topPerformers, recommendations
+- `markdown`: formatted markdown report string

package/config/skills/agent/marketing/weekly-marketing-report/execute.sh

@@ -0,0 +1,190 @@
+#!/bin/bash
+# Weekly Marketing Report — reads calendar data and generates a structured performance report
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"projectPath\":\"/path\",\"weekEndDate\":\"YYYY-MM-DD\",\"businessName\":\"...\"}'"
+
+# Parse parameters
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+WEEK_END=$(echo "$INPUT" | jq -r '.weekEndDate // empty')
+BUSINESS_NAME=$(echo "$INPUT" | jq -r '.businessName // empty')
+CALENDAR_PATH=$(echo "$INPUT" | jq -r '.calendarPath // empty')
+
+require_param "weekEndDate" "$WEEK_END"
+require_param "businessName" "$BUSINESS_NAME"
+
+# Determine calendar path
+if [ -z "$CALENDAR_PATH" ]; then
+  if [ -n "$PROJECT_PATH" ]; then
+    CALENDAR_PATH="${PROJECT_PATH}/.crewly/content/calendar.json"
+  else
+    CALENDAR_PATH="${HOME}/.crewly/content/calendar.json"
+  fi
+fi
+
+# Check if calendar file exists
+if [ ! -f "$CALENDAR_PATH" ]; then
+  # Return empty report if no calendar data
+  jq -n \
+    --arg businessName "$BUSINESS_NAME" \
+    --arg weekEnd "$WEEK_END" \
+    '{
+      "success": true,
+      "report": {
+        "businessName": $businessName,
+        "weekEndDate": $weekEnd,
+        "summary": "No content calendar data found. Start by creating a weekly content plan.",
+        "totalPosts": 0,
+        "platformBreakdown": {},
+        "statusBreakdown": {},
+        "completionRate": 0,
+        "topPerformers": [],
+        "recommendations": ["Set up a content calendar using the weekly-content-planning skill.", "Define target platforms and content mix ratios.", "Establish baseline metrics for future comparison."]
+      },
+      "markdown": "# Weekly Marketing Report — Week ending '"$WEEK_END"'\n\n## Summary\nNo content calendar data found. Start by creating a weekly content plan.\n\n## Recommendations\n1. Set up a content calendar using the weekly-content-planning skill.\n2. Define target platforms and content mix ratios.\n3. Establish baseline metrics for future comparison."
+    }'
+  exit 0
+fi
+
+# Validate calendar JSON
+if ! jq empty "$CALENDAR_PATH" 2>/dev/null; then
+  error_exit "Calendar file is not valid JSON: $CALENDAR_PATH"
+fi
+
+# Calculate week start (6 days before week end = 7-day window)
+if date -v-6d +%Y-%m-%d 2>/dev/null >/dev/null; then
+  # macOS: -v flag must come before -f
+  WEEK_START=$(date -j -v-6d -f "%Y-%m-%d" "$WEEK_END" +%Y-%m-%d 2>/dev/null || echo "$WEEK_END")
+else
+  # GNU/Linux date
+  WEEK_START=$(date -d "$WEEK_END - 6 days" +%Y-%m-%d 2>/dev/null || echo "$WEEK_END")
+fi
+
+# Filter entries for this week
+WEEK_ENTRIES=$(jq --arg from "$WEEK_START" --arg to "$WEEK_END" \
+  '[.entries[] | select(.scheduledDate >= $from and .scheduledDate <= $to)]' \
+  "$CALENDAR_PATH")
+
+TOTAL_POSTS=$(echo "$WEEK_ENTRIES" | jq 'length')
+
+# Posts by platform
+BY_PLATFORM=$(echo "$WEEK_ENTRIES" | jq '[.[] | .platform] | group_by(.) | map({(.[0]): length}) | add // {}')
+
+# Posts by status
+BY_STATUS=$(echo "$WEEK_ENTRIES" | jq '[.[] | .status] | group_by(.) | map({(.[0]): length}) | add // {}')
+
+# Completion rate (published / total)
+PUBLISHED_COUNT=$(echo "$WEEK_ENTRIES" | jq '[.[] | select(.status == "published")] | length')
+if [ "$TOTAL_POSTS" -gt 0 ]; then
+  COMPLETION_RATE=$(( (PUBLISHED_COUNT * 100) / TOTAL_POSTS ))
+else
+  COMPLETION_RATE=0
+fi
+
+# Posts by content type
+BY_TYPE=$(echo "$WEEK_ENTRIES" | jq '[.[] | .type] | group_by(.) | map({(.[0]): length}) | add // {}')
+
+# Draft/ready/approved breakdown for pipeline health
+DRAFT_COUNT=$(echo "$WEEK_ENTRIES" | jq '[.[] | select(.status == "draft")] | length')
+READY_COUNT=$(echo "$WEEK_ENTRIES" | jq '[.[] | select(.status == "ready")] | length')
+APPROVED_COUNT=$(echo "$WEEK_ENTRIES" | jq '[.[] | select(.status == "approved")] | length')
+
+# Top performers — published entries (most recently published)
+TOP_PERFORMERS=$(echo "$WEEK_ENTRIES" | jq '[.[] | select(.status == "published")] | sort_by(.publishedAt) | reverse | .[:3] | [.[] | {title: .title, platform: .platform, type: .type, scheduledDate: .scheduledDate}]')
+
+# Generate recommendations
+RECOMMENDATIONS="[]"
+
+if [ "$TOTAL_POSTS" -eq 0 ]; then
+  RECOMMENDATIONS=$(echo "$RECOMMENDATIONS" | jq '. += ["No posts scheduled this week. Create a content plan using the weekly-content-planning skill."]')
+elif [ "$TOTAL_POSTS" -lt 5 ]; then
+  RECOMMENDATIONS=$(echo "$RECOMMENDATIONS" | jq --argjson count "$TOTAL_POSTS" '. += ["Only \($count) posts scheduled. Target 5-7 posts per week for consistent presence."]')
+fi
+
+if [ "$DRAFT_COUNT" -gt 0 ]; then
+  RECOMMENDATIONS=$(echo "$RECOMMENDATIONS" | jq --argjson count "$DRAFT_COUNT" '. += ["\($count) posts still in draft. Prioritize moving them to ready status."]')
+fi
+
+if [ "$COMPLETION_RATE" -lt 50 ] && [ "$TOTAL_POSTS" -gt 0 ]; then
+  RECOMMENDATIONS=$(echo "$RECOMMENDATIONS" | jq --argjson rate "$COMPLETION_RATE" '. += ["Completion rate is \($rate)%. Investigate bottlenecks in the content pipeline."]')
+fi
+
+PLATFORM_COUNT=$(echo "$BY_PLATFORM" | jq 'keys | length')
+if [ "$PLATFORM_COUNT" -le 1 ] && [ "$TOTAL_POSTS" -gt 0 ]; then
+  RECOMMENDATIONS=$(echo "$RECOMMENDATIONS" | jq '. += ["Content concentrated on single platform. Diversify across 2-3 platforms for wider reach."]')
+fi
+
+# If no specific recommendations, add general ones
+REC_COUNT=$(echo "$RECOMMENDATIONS" | jq 'length')
+if [ "$REC_COUNT" -eq 0 ]; then
+  RECOMMENDATIONS='["Continue current posting cadence — metrics are on track.", "Experiment with one new content format next week.", "Review engagement data to identify top-performing content themes."]'
+fi
+
+# Build markdown report
+MARKDOWN="# Weekly Marketing Report — ${BUSINESS_NAME}\n"
+MARKDOWN="${MARKDOWN}## Week of ${WEEK_START} to ${WEEK_END}\n\n"
+MARKDOWN="${MARKDOWN}## Executive Summary\n"
+MARKDOWN="${MARKDOWN}Total posts scheduled: ${TOTAL_POSTS} | Published: ${PUBLISHED_COUNT} | Completion rate: ${COMPLETION_RATE}%\n\n"
+MARKDOWN="${MARKDOWN}## Platform Breakdown\n"
+MARKDOWN="${MARKDOWN}$(echo "$BY_PLATFORM" | jq -r 'to_entries | .[] | "- **\(.key)**: \(.value) posts"')\n\n"
+MARKDOWN="${MARKDOWN}## Status Breakdown\n"
+MARKDOWN="${MARKDOWN}$(echo "$BY_STATUS" | jq -r 'to_entries | .[] | "- **\(.key)**: \(.value)"')\n\n"
+MARKDOWN="${MARKDOWN}## Pipeline Health\n"
+MARKDOWN="${MARKDOWN}| Stage | Count |\n|-------|-------|\n"
+MARKDOWN="${MARKDOWN}| Draft | ${DRAFT_COUNT} |\n"
+MARKDOWN="${MARKDOWN}| Ready | ${READY_COUNT} |\n"
+MARKDOWN="${MARKDOWN}| Approved | ${APPROVED_COUNT} |\n"
+MARKDOWN="${MARKDOWN}| Published | ${PUBLISHED_COUNT} |\n\n"
+
+if [ "$(echo "$TOP_PERFORMERS" | jq 'length')" -gt 0 ]; then
+  MARKDOWN="${MARKDOWN}## Top Performers\n"
+  MARKDOWN="${MARKDOWN}$(echo "$TOP_PERFORMERS" | jq -r '.[] | "- **\(.title)** — \(.platform) (\(.type))"')\n\n"
+fi
+
+MARKDOWN="${MARKDOWN}## Recommendations\n"
+MARKDOWN="${MARKDOWN}$(echo "$RECOMMENDATIONS" | jq -r 'to_entries | .[] | "\(.key + 1). \(.value)"')\n"
+
+# Build structured report JSON
+jq -n \
+  --arg businessName "$BUSINESS_NAME" \
+  --arg weekStart "$WEEK_START" \
+  --arg weekEnd "$WEEK_END" \
+  --argjson totalPosts "$TOTAL_POSTS" \
+  --argjson publishedCount "$PUBLISHED_COUNT" \
+  --argjson completionRate "$COMPLETION_RATE" \
+  --argjson platformBreakdown "$BY_PLATFORM" \
+  --argjson statusBreakdown "$BY_STATUS" \
+  --argjson typeBreakdown "$BY_TYPE" \
+  --argjson topPerformers "$TOP_PERFORMERS" \
+  --argjson recommendations "$RECOMMENDATIONS" \
+  --argjson draftCount "$DRAFT_COUNT" \
+  --argjson readyCount "$READY_COUNT" \
+  --argjson approvedCount "$APPROVED_COUNT" \
+  --arg markdown "$(echo -e "$MARKDOWN")" \
+  '{
+    "success": true,
+    "report": {
+      "businessName": $businessName,
+      "weekStartDate": $weekStart,
+      "weekEndDate": $weekEnd,
+      "summary": "Total: \($totalPosts) posts | Published: \($publishedCount) | Completion: \($completionRate)%",
+      "totalPosts": $totalPosts,
+      "publishedCount": $publishedCount,
+      "completionRate": $completionRate,
+      "platformBreakdown": $platformBreakdown,
+      "statusBreakdown": $statusBreakdown,
+      "typeBreakdown": $typeBreakdown,
+      "pipelineHealth": {
+        "draft": $draftCount,
+        "ready": $readyCount,
+        "approved": $approvedCount,
+        "published": $publishedCount
+      },
+      "topPerformers": $topPerformers,
+      "recommendations": $recommendations
+    },
+    "markdown": $markdown
+  }'