@open-loyalty/mcp-server 1.1.0 → 1.3.3

package/dist/workflows/index.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Fan Engagement Workflows
+ *
+ * Orchestrated workflows for setting up complete fan engagement campaigns.
+ * These combine multiple Open Loyalty tools into guided, step-by-step flows.
+ */
+import { matchAttendanceWorkflow, executeMatchAttendanceWorkflow, type MatchAttendanceConfig, type MatchAttendanceResult } from "./match-attendance.js";
+import { earlyArrivalWorkflow, executeEarlyArrivalWorkflow, type EarlyArrivalConfig, type EarlyArrivalResult } from "./early-arrival.js";
+import { sportsbarVisitWorkflow, executeSportsbarVisitWorkflow, type SportsbarVisitConfig, type SportsbarVisitResult } from "./sportsbar-visit.js";
+import { vodWatchingWorkflow, executeVodWatchingWorkflow, type VodWatchingConfig, type VodWatchingResult } from "./vod-watching.js";
+import { appLoginStreakWorkflow, executeAppLoginStreakWorkflow, type AppLoginStreakConfig, type AppLoginStreakResult } from "./app-login-streak.js";
+export { matchAttendanceWorkflow, executeMatchAttendanceWorkflow, type MatchAttendanceConfig, type MatchAttendanceResult, };
+export { earlyArrivalWorkflow, executeEarlyArrivalWorkflow, type EarlyArrivalConfig, type EarlyArrivalResult, };
+export { sportsbarVisitWorkflow, executeSportsbarVisitWorkflow, type SportsbarVisitConfig, type SportsbarVisitResult, };
+export { vodWatchingWorkflow, executeVodWatchingWorkflow, type VodWatchingConfig, type VodWatchingResult, };
+export { appLoginStreakWorkflow, executeAppLoginStreakWorkflow, type AppLoginStreakConfig, type AppLoginStreakResult, };
+export { DEFAULTS, ALL_WORKFLOWS, findMatchingWorkflow, getWorkflowById, parseCommaSeparated, parseMilestones, formatOLDate, AGENT_PROMPTS, type WorkflowDefinition, type WorkflowQuestion, type WorkflowStep, } from "../prompts/fan-engagement-setup.js";
+export interface FanEngagementConfig {
+    /** Match attendance configuration */
+    matchAttendance?: Partial<MatchAttendanceConfig>;
+    /** Early arrival configuration */
+    earlyArrival?: Partial<EarlyArrivalConfig>;
+    /** Sports bar visit configuration */
+    sportsbarVisit?: Partial<SportsbarVisitConfig>;
+    /** VOD watching configuration */
+    vodWatching?: Partial<VodWatchingConfig>;
+    /** App login streak configuration */
+    appLoginStreak?: Partial<AppLoginStreakConfig>;
+    /** Which workflows to execute (default: all) */
+    enabledWorkflows?: ("match-attendance" | "early-arrival" | "sportsbar-visit" | "vod-watching" | "app-login-streak")[];
+}
+export interface FanEngagementResult {
+    success: boolean;
+    results: {
+        matchAttendance?: MatchAttendanceResult;
+        earlyArrival?: EarlyArrivalResult;
+        sportsbarVisit?: SportsbarVisitResult;
+        vodWatching?: VodWatchingResult;
+        appLoginStreak?: AppLoginStreakResult;
+    };
+    summary: string;
+    totalCampaigns: number;
+    totalAchievements: number;
+    errors: string[];
+}
+/**
+ * Execute all fan engagement workflows
+ *
+ * This is the master workflow that orchestrates all individual workflows
+ * based on the provided configuration.
+ */
+export declare function executeAllFanEngagementWorkflows(config?: FanEngagementConfig): Promise<FanEngagementResult>;
+export declare const allWorkflows: readonly [{
+    id: string;
+    name: string;
+    execute: typeof executeMatchAttendanceWorkflow;
+}, {
+    id: string;
+    name: string;
+    execute: typeof executeEarlyArrivalWorkflow;
+}, {
+    id: string;
+    name: string;
+    execute: typeof executeSportsbarVisitWorkflow;
+}, {
+    id: string;
+    name: string;
+    execute: typeof executeVodWatchingWorkflow;
+}, {
+    id: string;
+    name: string;
+    execute: typeof executeAppLoginStreakWorkflow;
+}];
+/**
+ * Get workflow by ID
+ */
+export declare function getWorkflow(id: string): {
+    id: string;
+    name: string;
+    execute: typeof executeAppLoginStreakWorkflow;
+} | {
+    id: string;
+    name: string;
+    execute: typeof executeEarlyArrivalWorkflow;
+} | {
+    id: string;
+    name: string;
+    execute: typeof executeMatchAttendanceWorkflow;
+} | {
+    id: string;
+    name: string;
+    execute: typeof executeSportsbarVisitWorkflow;
+} | {
+    id: string;
+    name: string;
+    execute: typeof executeVodWatchingWorkflow;
+} | undefined;
+/**
+ * Execute a workflow by ID with given config
+ */
+export declare function executeWorkflowById(id: string, config?: Record<string, unknown>): Promise<unknown>;

package/dist/workflows/index.js

@@ -0,0 +1,208 @@
+/**
+ * Fan Engagement Workflows
+ *
+ * Orchestrated workflows for setting up complete fan engagement campaigns.
+ * These combine multiple Open Loyalty tools into guided, step-by-step flows.
+ */
+// Import execute functions for internal use
+import { matchAttendanceWorkflow, executeMatchAttendanceWorkflow, } from "./match-attendance.js";
+import { earlyArrivalWorkflow, executeEarlyArrivalWorkflow, } from "./early-arrival.js";
+import { sportsbarVisitWorkflow, executeSportsbarVisitWorkflow, } from "./sportsbar-visit.js";
+import { vodWatchingWorkflow, executeVodWatchingWorkflow, } from "./vod-watching.js";
+import { appLoginStreakWorkflow, executeAppLoginStreakWorkflow, } from "./app-login-streak.js";
+// Re-export all workflow components
+export { matchAttendanceWorkflow, executeMatchAttendanceWorkflow, };
+export { earlyArrivalWorkflow, executeEarlyArrivalWorkflow, };
+export { sportsbarVisitWorkflow, executeSportsbarVisitWorkflow, };
+export { vodWatchingWorkflow, executeVodWatchingWorkflow, };
+export { appLoginStreakWorkflow, executeAppLoginStreakWorkflow, };
+// Re-export prompt utilities
+export { DEFAULTS, ALL_WORKFLOWS, findMatchingWorkflow, getWorkflowById, parseCommaSeparated, parseMilestones, formatOLDate, AGENT_PROMPTS, } from "../prompts/fan-engagement-setup.js";
+// ============================================================================
+// Master Workflow
+// ============================================================================
+/**
+ * Execute all fan engagement workflows
+ *
+ * This is the master workflow that orchestrates all individual workflows
+ * based on the provided configuration.
+ */
+export async function executeAllFanEngagementWorkflows(config = {}) {
+    const enabledWorkflows = config.enabledWorkflows || [
+        "match-attendance",
+        "early-arrival",
+        "sportsbar-visit",
+        "vod-watching",
+        "app-login-streak",
+    ];
+    const result = {
+        success: false,
+        results: {},
+        summary: "",
+        totalCampaigns: 0,
+        totalAchievements: 0,
+        errors: [],
+    };
+    try {
+        // Execute each enabled workflow
+        for (const workflowId of enabledWorkflows) {
+            switch (workflowId) {
+                case "match-attendance": {
+                    const maResult = await executeMatchAttendanceWorkflow(config.matchAttendance);
+                    result.results.matchAttendance = maResult;
+                    if (maResult.baseCampaignId)
+                        result.totalCampaigns++;
+                    result.totalCampaigns += maResult.achievements.filter((a) => a.bonusCampaignId).length;
+                    result.totalAchievements += maResult.achievements.length;
+                    result.errors.push(...maResult.errors);
+                    break;
+                }
+                case "early-arrival": {
+                    const eaResult = await executeEarlyArrivalWorkflow(config.earlyArrival);
+                    result.results.earlyArrival = eaResult;
+                    if (eaResult.campaignId)
+                        result.totalCampaigns++;
+                    result.errors.push(...eaResult.errors);
+                    break;
+                }
+                case "sportsbar-visit": {
+                    const sbResult = await executeSportsbarVisitWorkflow(config.sportsbarVisit);
+                    result.results.sportsbarVisit = sbResult;
+                    if (sbResult.visitCampaignId)
+                        result.totalCampaigns++;
+                    if (sbResult.bonusCampaignId)
+                        result.totalCampaigns++;
+                    if (sbResult.achievementId)
+                        result.totalAchievements++;
+                    result.errors.push(...sbResult.errors);
+                    break;
+                }
+                case "vod-watching": {
+                    const vodResult = await executeVodWatchingWorkflow(config.vodWatching);
+                    result.results.vodWatching = vodResult;
+                    if (vodResult.watchCampaignId)
+                        result.totalCampaigns++;
+                    if (vodResult.bonusCampaignId)
+                        result.totalCampaigns++;
+                    if (vodResult.achievementId)
+                        result.totalAchievements++;
+                    result.errors.push(...vodResult.errors);
+                    break;
+                }
+                case "app-login-streak": {
+                    const loginResult = await executeAppLoginStreakWorkflow(config.appLoginStreak);
+                    result.results.appLoginStreak = loginResult;
+                    if (loginResult.loginCampaignId)
+                        result.totalCampaigns++;
+                    if (loginResult.streakBonusCampaignId)
+                        result.totalCampaigns++;
+                    if (loginResult.streakAchievementId)
+                        result.totalAchievements++;
+                    result.errors.push(...loginResult.errors);
+                    break;
+                }
+            }
+        }
+        // Determine overall success
+        result.success = result.errors.length === 0 && result.totalCampaigns > 0;
+        // Build summary
+        result.summary = buildMasterSummary(result);
+    }
+    catch (error) {
+        result.errors.push(`Master workflow error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return result;
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function buildMasterSummary(result) {
+    const lines = [];
+    lines.push(`Fan Engagement Program Setup Complete!`);
+    lines.push(`========================================`);
+    lines.push(`\nCreated: ${result.totalCampaigns} campaigns, ${result.totalAchievements} achievements`);
+    // Match Attendance
+    if (result.results.matchAttendance) {
+        const ma = result.results.matchAttendance;
+        if (ma.baseCampaignId) {
+            lines.push(`\nMatch Attendance:`);
+            lines.push(`  - Base campaign: ${ma.baseCampaignId}`);
+            if (ma.achievements.length > 0) {
+                lines.push(`  - Achievements: ${ma.achievements.map((a) => a.milestone).join(", ")} matches`);
+            }
+        }
+    }
+    // Early Arrival
+    if (result.results.earlyArrival?.campaignId) {
+        lines.push(`\nEarly Arrival:`);
+        lines.push(`  - Campaign: ${result.results.earlyArrival.campaignId}`);
+    }
+    // Sports Bar
+    if (result.results.sportsbarVisit?.visitCampaignId) {
+        lines.push(`\nSports Bar Visits:`);
+        lines.push(`  - Visit campaign: ${result.results.sportsbarVisit.visitCampaignId}`);
+        if (result.results.sportsbarVisit.achievementId) {
+            lines.push(`  - Achievement: ${result.results.sportsbarVisit.achievementId}`);
+        }
+    }
+    // VOD Watching
+    if (result.results.vodWatching?.watchCampaignId) {
+        lines.push(`\nVOD Watching:`);
+        lines.push(`  - Watch campaign: ${result.results.vodWatching.watchCampaignId}`);
+        if (result.results.vodWatching.achievementId) {
+            lines.push(`  - Achievement: ${result.results.vodWatching.achievementId}`);
+        }
+    }
+    // App Login
+    if (result.results.appLoginStreak?.loginCampaignId) {
+        lines.push(`\nApp Login Streak:`);
+        lines.push(`  - Login campaign: ${result.results.appLoginStreak.loginCampaignId}`);
+        if (result.results.appLoginStreak.streakAchievementId) {
+            lines.push(`  - Streak achievement: ${result.results.appLoginStreak.streakAchievementId}`);
+        }
+    }
+    // Custom events reference
+    lines.push(`\nCustom Events Reference:`);
+    lines.push(`  - match_attendance: Triggered when fan scans at stadium entry`);
+    lines.push(`  - early_arrival: Triggered when fan arrives early (needs minutes_before attribute)`);
+    lines.push(`  - sportsbar_visit: Triggered when fan visits the sports bar`);
+    lines.push(`  - vod_watch: Triggered when fan watches video (needs minutes_watched attribute)`);
+    lines.push(`  - app_login: Triggered on daily app login`);
+    // Errors
+    if (result.errors.length > 0) {
+        lines.push(`\nWarnings/Errors (${result.errors.length}):`);
+        for (const error of result.errors.slice(0, 5)) {
+            lines.push(`  - ${error}`);
+        }
+        if (result.errors.length > 5) {
+            lines.push(`  ... and ${result.errors.length - 5} more`);
+        }
+    }
+    return lines.join("\n");
+}
+// ============================================================================
+// All Workflows Registry
+// ============================================================================
+export const allWorkflows = [
+    matchAttendanceWorkflow,
+    earlyArrivalWorkflow,
+    sportsbarVisitWorkflow,
+    vodWatchingWorkflow,
+    appLoginStreakWorkflow,
+];
+/**
+ * Get workflow by ID
+ */
+export function getWorkflow(id) {
+    return allWorkflows.find((w) => w.id === id);
+}
+/**
+ * Execute a workflow by ID with given config
+ */
+export async function executeWorkflowById(id, config) {
+    const workflow = getWorkflow(id);
+    if (!workflow) {
+        throw new Error(`Workflow not found: ${id}`);
+    }
+    return workflow.execute(config);
+}

package/dist/workflows/match-attendance.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Match Attendance Workflow
+ *
+ * Creates a complete match attendance reward program including:
+ * - Base campaign for per-match coin rewards
+ * - Achievements for attendance milestones (6, 12 matches, etc.)
+ * - Bonus campaigns triggered by achievement completion
+ */
+export interface MatchAttendanceConfig {
+    /** Coins awarded per match attendance */
+    coinsPerMatch: number;
+    /** Attendance milestones for achievements (e.g., [6, 12] or [6, 12, "80%"]) */
+    milestones: (number | string)[];
+    /** Badge names for each milestone */
+    badgeNames: string[];
+    /** Bonus coins for each milestone */
+    milestoneBonuses: number[];
+    /** Maximum attendances counted per day (anti-fraud) */
+    limitPerDay: number;
+    /** Season start date (ISO format) */
+    seasonStart: string;
+    /** Season end date (ISO format) */
+    seasonEnd: string;
+}
+export interface MatchAttendanceResult {
+    success: boolean;
+    baseCampaignId?: string;
+    achievements: Array<{
+        achievementId: string;
+        milestone: number | string;
+        badgeName: string;
+        bonusCampaignId?: string;
+    }>;
+    errors: string[];
+    summary: string;
+}
+/**
+ * Execute the match attendance workflow
+ */
+export declare function executeMatchAttendanceWorkflow(config?: Partial<MatchAttendanceConfig>): Promise<MatchAttendanceResult>;
+export declare const matchAttendanceWorkflow: {
+    id: string;
+    name: string;
+    execute: typeof executeMatchAttendanceWorkflow;
+};

package/dist/workflows/match-attendance.js

@@ -0,0 +1,308 @@
+/**
+ * Match Attendance Workflow
+ *
+ * Creates a complete match attendance reward program including:
+ * - Base campaign for per-match coin rewards
+ * - Achievements for attendance milestones (6, 12 matches, etc.)
+ * - Bonus campaigns triggered by achievement completion
+ */
+import { campaignCreate, campaignList } from "../tools/campaign/handlers.js";
+import { achievementCreate, achievementList } from "../tools/achievement.js";
+import { badgeList } from "../tools/badge.js";
+import { formatOLDate, DEFAULTS } from "../prompts/fan-engagement-setup.js";
+// ============================================================================
+// Workflow Implementation
+// ============================================================================
+/**
+ * Execute the match attendance workflow
+ */
+export async function executeMatchAttendanceWorkflow(config = {}) {
+    const result = {
+        success: false,
+        achievements: [],
+        errors: [],
+        summary: "",
+    };
+    // Merge with defaults
+    const cfg = {
+        coinsPerMatch: config.coinsPerMatch ?? DEFAULTS.matchAttendance.coinsPerMatch,
+        milestones: config.milestones ?? DEFAULTS.matchAttendance.milestones,
+        badgeNames: config.badgeNames ?? Object.values(DEFAULTS.matchAttendance.badges),
+        milestoneBonuses: config.milestoneBonuses ?? Object.values(DEFAULTS.matchAttendance.milestoneBonuses),
+        limitPerDay: config.limitPerDay ?? DEFAULTS.matchAttendance.limitPerDay,
+        seasonStart: config.seasonStart ?? DEFAULTS.seasonDates.start,
+        seasonEnd: config.seasonEnd ?? DEFAULTS.seasonDates.end,
+    };
+    try {
+        // Step 1: Create base match attendance campaign
+        const baseCampaignResult = await createBaseCampaign(cfg);
+        if (baseCampaignResult.error) {
+            result.errors.push(baseCampaignResult.error);
+        }
+        else {
+            result.baseCampaignId = baseCampaignResult.campaignId;
+        }
+        // Step 2: Get available badges for achievements
+        const badges = await getAvailableBadges();
+        // Step 3: Create achievements and bonus campaigns for each milestone
+        for (let i = 0; i < cfg.milestones.length; i++) {
+            const milestone = cfg.milestones[i];
+            const badgeName = cfg.badgeNames[i] || `Milestone ${milestone}`;
+            const bonus = cfg.milestoneBonuses[i] || 500;
+            const achievementResult = await createMilestoneAchievement(milestone, badgeName, badges, cfg.seasonStart, cfg.seasonEnd);
+            if (achievementResult.error) {
+                result.errors.push(achievementResult.error);
+                continue;
+            }
+            const achievementEntry = {
+                achievementId: achievementResult.achievementId,
+                milestone,
+                badgeName,
+            };
+            // Create bonus campaign for this achievement
+            if (achievementResult.achievementId) {
+                const bonusCampaignResult = await createAchievementBonusCampaign(achievementResult.achievementId, milestone, bonus, cfg.seasonStart, cfg.seasonEnd);
+                if (bonusCampaignResult.error) {
+                    result.errors.push(bonusCampaignResult.error);
+                }
+                else {
+                    achievementEntry.bonusCampaignId = bonusCampaignResult.campaignId;
+                }
+            }
+            result.achievements.push(achievementEntry);
+        }
+        // Step 4: Verify setup
+        const verification = await verifySetup(result);
+        if (verification.warnings.length > 0) {
+            result.errors.push(...verification.warnings);
+        }
+        // Build summary
+        result.success = result.baseCampaignId !== undefined && result.errors.length === 0;
+        result.summary = buildSummary(cfg, result);
+    }
+    catch (error) {
+        result.errors.push(`Workflow error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return result;
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+async function createBaseCampaign(cfg) {
+    try {
+        const response = await campaignCreate({
+            type: "direct",
+            trigger: "custom_event",
+            event: "match_attendance",
+            translations: {
+                en: {
+                    name: "Match Attendance Reward",
+                    description: `Earn ${cfg.coinsPerMatch} coins for each match you attend`,
+                },
+            },
+            activity: {
+                startsAt: formatOLDate(cfg.seasonStart),
+                endsAt: formatOLDate(cfg.seasonEnd),
+            },
+            rules: [
+                {
+                    name: "Award coins for match attendance",
+                    effects: [
+                        {
+                            effect: "give_points",
+                            pointsRule: { fixedValue: cfg.coinsPerMatch },
+                        },
+                    ],
+                },
+            ],
+            limits: {
+                executionsPerMember: {
+                    value: cfg.limitPerDay,
+                    interval: { type: "days", value: 1 },
+                },
+            },
+            active: true,
+        });
+        return { campaignId: response.campaignId };
+    }
+    catch (error) {
+        return {
+            error: `Failed to create base campaign: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+async function getAvailableBadges() {
+    try {
+        const response = await badgeList({});
+        const badgeMap = new Map();
+        for (const badge of response.badges) {
+            if (badge.name && badge.badgeTypeId) {
+                badgeMap.set(badge.name.toLowerCase(), badge.badgeTypeId);
+            }
+        }
+        return badgeMap;
+    }
+    catch {
+        // Return empty map if badges can't be fetched - achievements will be created without badges
+        return new Map();
+    }
+}
+async function createMilestoneAchievement(milestone, badgeName, badges, seasonStart, seasonEnd) {
+    try {
+        // Find badge ID by name (case-insensitive)
+        const badgeTypeId = badges.get(badgeName.toLowerCase());
+        // Determine the goal value (for percentage, calculate based on assumed total matches)
+        let periodGoal;
+        let achievementName;
+        let achievementDescription;
+        if (typeof milestone === "string" && milestone.includes("%")) {
+            // Percentage milestone (e.g., "80%")
+            const percentage = parseInt(milestone.replace("%", ""), 10);
+            // Assume ~19 home matches per season (typical for major football leagues)
+            periodGoal = Math.ceil(19 * (percentage / 100));
+            achievementName = `${milestone} Match Attendance`;
+            achievementDescription = `Attend ${milestone} of all home matches this season`;
+        }
+        else {
+            periodGoal = typeof milestone === "number" ? milestone : parseInt(milestone, 10);
+            achievementName = `Attend ${periodGoal} Matches`;
+            achievementDescription = `Be at ${periodGoal} home games this season`;
+        }
+        const achievementPayload = {
+            translations: {
+                en: {
+                    name: achievementName,
+                    description: achievementDescription,
+                },
+            },
+            active: true,
+            activity: {
+                startsAt: formatOLDate(seasonStart),
+                endsAt: formatOLDate(seasonEnd),
+            },
+            rules: [
+                {
+                    trigger: "custom_event",
+                    event: "match_attendance",
+                    completeRule: {
+                        periodGoal,
+                    },
+                },
+            ],
+        };
+        // Add badge if found
+        if (badgeTypeId) {
+            achievementPayload.badgeTypeId = badgeTypeId;
+        }
+        const response = await achievementCreate(achievementPayload);
+        return { achievementId: response.achievementId };
+    }
+    catch (error) {
+        return {
+            error: `Failed to create achievement for ${milestone}: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+async function createAchievementBonusCampaign(achievementId, milestone, bonusCoins, seasonStart, seasonEnd) {
+    try {
+        const milestoneLabel = typeof milestone === "string" ? milestone : `${milestone} Matches`;
+        const response = await campaignCreate({
+            type: "direct",
+            trigger: "achievement",
+            translations: {
+                en: {
+                    name: `${milestoneLabel} Achievement Bonus`,
+                    description: `Bonus ${bonusCoins} coins for completing the ${milestoneLabel} achievement`,
+                },
+            },
+            activity: {
+                startsAt: formatOLDate(seasonStart),
+                endsAt: formatOLDate(seasonEnd),
+            },
+            rules: [
+                {
+                    name: `Bonus for completing ${milestoneLabel}`,
+                    effects: [
+                        {
+                            effect: "give_points",
+                            pointsRule: { fixedValue: bonusCoins },
+                        },
+                    ],
+                    conditions: [
+                        {
+                            operator: "is_equal",
+                            attribute: "achievement.achievementId",
+                            data: { value: achievementId },
+                        },
+                    ],
+                },
+            ],
+            active: true,
+        });
+        return { campaignId: response.campaignId };
+    }
+    catch (error) {
+        return {
+            error: `Failed to create bonus campaign for ${milestone}: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+async function verifySetup(result) {
+    const warnings = [];
+    try {
+        // Verify campaigns exist
+        if (result.baseCampaignId) {
+            const campaigns = await campaignList({ active: true });
+            const found = campaigns.campaigns.some((c) => c.campaignId === result.baseCampaignId);
+            if (!found) {
+                warnings.push("Base campaign created but not found in active campaigns list");
+            }
+        }
+        // Verify achievements exist
+        if (result.achievements.length > 0) {
+            const achievements = await achievementList({ active: true });
+            for (const ach of result.achievements) {
+                const found = achievements.achievements.some((a) => a.achievementId === ach.achievementId);
+                if (!found) {
+                    warnings.push(`Achievement ${ach.milestone} created but not found in active achievements list`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        warnings.push(`Verification error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return { warnings };
+}
+function buildSummary(cfg, result) {
+    const lines = [];
+    if (result.baseCampaignId) {
+        lines.push(`Fans will earn ${cfg.coinsPerMatch} coins per match attended`);
+    }
+    if (result.achievements.length > 0) {
+        lines.push(`\nMilestone achievements created:`);
+        for (const ach of result.achievements) {
+            const bonusText = ach.bonusCampaignId
+                ? ` (+ ${cfg.milestoneBonuses[result.achievements.indexOf(ach)] || 500} coin bonus)`
+                : "";
+            lines.push(`- ${ach.milestone} matches: ${ach.badgeName} badge${bonusText}`);
+        }
+    }
+    lines.push(`\nSeason: ${cfg.seasonStart} to ${cfg.seasonEnd}`);
+    lines.push(`Anti-fraud: Max ${cfg.limitPerDay} attendance${cfg.limitPerDay > 1 ? "s" : ""} per day`);
+    if (result.errors.length > 0) {
+        lines.push(`\nWarnings/Errors:`);
+        for (const error of result.errors) {
+            lines.push(`- ${error}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export const matchAttendanceWorkflow = {
+    id: "match-attendance",
+    name: "Match Attendance Campaign",
+    execute: executeMatchAttendanceWorkflow,
+};