outcome-cli 1.0.0

package/src/outcomes/content_creation_battle.ts

@@ -0,0 +1,160 @@
+/**
+ * Content Creation Battle Outcome
+ *
+ * Visual content generation competition where AI agents create
+ * images, graphics, and visual assets for marketing campaigns.
+ *
+ * @module outcomes/content_creation_battle
+ */
+
+import type { Outcome } from './outcome.schema.js';
+
+/**
+ * Payout amount for successfully completing a content creation battle.
+ */
+export const CONTENT_CREATION_PAYOUT = 50;
+
+/**
+ * Maximum number of attempts an agent can make.
+ */
+export const CONTENT_CREATION_MAX_ATTEMPTS = 3;
+
+/**
+ * Time limit for creating content (5 minutes).
+ */
+export const CONTENT_CREATION_TIME_LIMIT_MS = 300000;
+
+/**
+ * Content creation brief for the battle
+ */
+export interface ContentBrief {
+  /** Type of content to create */
+  contentType: 'social_media' | 'hero_banner' | 'product_showcase' | 'brand_illustration';
+  /** Target audience description */
+  audience: string;
+  /** Brand or company information */
+  brand: {
+    name: string;
+    industry: string;
+    tone: 'professional' | 'casual' | 'playful' | 'luxury' | 'tech';
+    colors?: string[];
+  };
+  /** Specific requirements */
+  requirements: {
+    dimensions: string; // e.g., "1080x1080", "1920x1080"
+    style?: string; // e.g., "minimalist", "vibrant", "corporate"
+    mustInclude?: string[]; // Elements that must be present
+    mustAvoid?: string[]; // Elements to avoid
+  };
+  /** Campaign context */
+  campaign: {
+    objective: string; // e.g., "increase brand awareness", "drive sales"
+    message: string; // Key message to communicate
+    callToAction?: string; // CTA if applicable
+  };
+}
+
+/**
+ * Content creation artifact produced by an agent
+ */
+export interface ContentCreationArtifact {
+  /** Generated images */
+  images: Array<{
+    imageBytes: string; // Base64 encoded
+    mimeType: string;
+    description: string;
+  }>;
+  /** Creative brief interpretation */
+  concept: {
+    title: string;
+    description: string;
+    rationale: string; // Why this approach works for the brief
+  };
+  /** Technical specifications */
+  specs: {
+    dimensions: string;
+    style: string;
+    colorPalette: string[];
+  };
+  /** Prompt used for generation */
+  prompt: string;
+}
+
+/**
+ * Default content brief for battles
+ */
+export const DEFAULT_CONTENT_BRIEF: ContentBrief = {
+  contentType: 'social_media',
+  audience: 'Tech-savvy entrepreneurs and startup founders',
+  brand: {
+    name: 'WAI Championship',
+    industry: 'AI/Technology',
+    tone: 'tech',
+    colors: ['#8B5CF6', '#10B981', '#3B82F6']
+  },
+  requirements: {
+    dimensions: '1080x1080',
+    style: 'modern tech aesthetic',
+    mustInclude: ['AI agents', 'competition theme'],
+    mustAvoid: ['cluttered design', 'outdated graphics']
+  },
+  campaign: {
+    objective: 'increase platform awareness',
+    message: 'AI agents compete for real bounties',
+    callToAction: 'Join the Championship'
+  }
+};
+
+/**
+ * Content Creation Battle Outcome Definition
+ *
+ * Success criteria:
+ * 1. Images match specified dimensions
+ * 2. Content aligns with brand guidelines
+ * 3. Includes required elements
+ * 4. Avoids prohibited elements
+ * 5. Demonstrates creative interpretation of brief
+ */
+export const contentCreationBattle: Outcome = {
+  name: 'content_creation_battle',
+  description: 'Visual Content Creation Battle - Generate compelling marketing visuals that align with brand guidelines and campaign objectives.',
+  payoutAmount: CONTENT_CREATION_PAYOUT,
+  maxAttempts: CONTENT_CREATION_MAX_ATTEMPTS,
+  timeLimitMs: CONTENT_CREATION_TIME_LIMIT_MS,
+  successCriteria: [
+    {
+      name: 'correct_dimensions',
+      validator: 'validateImageDimensions',
+      params: { expectedDimensions: '1080x1080' }
+    },
+    {
+      name: 'brand_alignment',
+      validator: 'validateBrandAlignment',
+      params: { brandGuidelines: DEFAULT_CONTENT_BRIEF.brand }
+    },
+    {
+      name: 'required_elements',
+      validator: 'validateRequiredElements',
+      params: { requiredElements: DEFAULT_CONTENT_BRIEF.requirements.mustInclude }
+    },
+    {
+      name: 'creative_quality',
+      validator: 'validateCreativeQuality',
+      params: { minQualityScore: 7 }
+    },
+    {
+      name: 'technical_specs',
+      validator: 'validateTechnicalSpecs',
+      params: { imageFormat: 'png', minResolution: 1080 }
+    }
+  ],
+  failureReasons: [
+    'Images do not match required dimensions',
+    'Content does not align with brand guidelines',
+    'Missing required elements from brief',
+    'Creative quality below acceptable threshold',
+    'Technical specifications not met'
+  ]
+};
+
+export default contentCreationBattle;

package/src/outcomes/f1_stem_opt_compliance.ts

@@ -0,0 +1,61 @@
+import type { Outcome } from './outcome.schema.js';
+
+export const f1StemOPTCompliance: Outcome = {
+  name: 'f1_stem_opt_compliance',
+  description: 'Verify Form I-983 Training Plan meets all USCIS requirements for F1 STEM OPT extension',
+  payoutAmount: 199,
+  maxAttempts: 3,
+  timeLimitMs: 120000,
+  successCriteria: [
+    {
+      name: 'required_student_fields',
+      validator: 'validateI983RequiredFields',
+      params: {
+        requiredFields: ['student_name', 'student_email', 'sevis_id', 'school_name', 'degree_level', 'cip_code']
+      }
+    },
+    {
+      name: 'required_employer_fields',
+      validator: 'validateI983RequiredFields',
+      params: {
+        requiredFields: ['employer_name', 'employer_ein', 'employer_everify', 'employer_address']
+      }
+    },
+    {
+      name: 'required_training_fields',
+      validator: 'validateI983RequiredFields',
+      params: {
+        requiredFields: ['position_title', 'training_start_date', 'training_end_date', 'training_description']
+      }
+    },
+    {
+      name: 'training_start_date_range',
+      validator: 'validateOPTDateRange',
+      params: { field: 'training_start_date', minDaysFromNow: 0, maxDaysFromNow: 540 }
+    },
+    {
+      name: 'training_end_date_range',
+      validator: 'validateOPTDateRange',
+      params: { field: 'training_end_date', minDaysFromNow: 30, maxDaysFromNow: 540 }
+    },
+    {
+      name: 'everify_format',
+      validator: 'validateEVerifyFormat',
+      params: { field: 'employer_everify' }
+    },
+    {
+      name: 'training_description_length',
+      validator: 'validateTrainingDescriptionLength',
+      params: { field: 'training_description', minWords: 50 }
+    }
+  ],
+  failureReasons: [
+    'Missing required student information',
+    'Missing required employer information',
+    'Missing required training plan details',
+    'OPT dates are outside valid range (must be within 540 days)',
+    'E-Verify number format is invalid (must be 8 digits)',
+    'Training description is too short (minimum 50 words)',
+    'Form fields are incomplete or incorrectly formatted'
+  ]
+};

package/src/outcomes/index.ts

@@ -0,0 +1,107 @@
+/**
+ * Outcomes Module Exports
+ *
+ * Includes both sales outcomes and SWE-bench style code outcomes.
+ *
+ * @module outcomes
+ */
+
+// Schema and validation
+export {
+  type Outcome,
+  type SuccessCriterion,
+  type ValidationResult,
+  validateOutcome,
+  isOutcome,
+} from './outcome.schema.js';
+
+// Sales outcomes (original)
+export {
+  qualifiedSalesInterest,
+  PAYOUT_AMOUNT,
+  MAX_ATTEMPTS,
+  TIME_LIMIT_MS,
+  BUYING_INTENT_KEYWORDS,
+  MIN_COMPANY_SIZE,
+  EXCLUDED_ROLES,
+  MIN_MESSAGE_WORDS,
+} from './qualified_sales_interest.js';
+
+// SWE-bench style code outcomes
+export {
+  type CodeOutcome,
+  CODE_OUTCOMES,
+  getCodeOutcomesByLevel,
+  getCodeOutcomesByCategory,
+  getCodeOutcomesByLanguage,
+} from './code-outcomes.js';
+
+// Outcome-based code delivery (feature/refactor/test generation)
+export {
+  featureImplementationOutcome,
+  refactorTaskOutcome,
+  testGenerationOutcome,
+  CODE_DELIVERY_OUTCOMES,
+} from './code-delivery-outcomes.js';
+
+// Snowdevil Hunter Squad outcome
+export {
+  acquirePilotCustomerOutcome,
+  PILOT_PAYOUT_AMOUNT,
+  PILOT_MAX_ATTEMPTS,
+  PILOT_TIME_LIMIT_MS,
+  POSITIVE_REPLY_KEYWORDS,
+  PAIN_SIGNALS,
+  MIN_OUTREACH_LENGTH,
+  MAX_OUTREACH_LENGTH,
+  validateContactInfo,
+  validatePainSignal,
+  validateOutreachSent,
+  validatePositiveReply,
+} from './acquire-pilot-customer.js';
+
+// Tournament Seed Bounties - Code Review Battle
+export {
+  codeReviewBattle,
+  CODE_REVIEW_PAYOUT,
+  CODE_REVIEW_MAX_ATTEMPTS,
+  CODE_REVIEW_TIME_LIMIT_MS,
+  type CodeReviewIssue,
+  type CodeReviewComment,
+  type RefactorSuggestion,
+  type CodeReviewArtifact,
+} from './code_review_battle.js';
+
+// Tournament Seed Bounties - Lead Gen Battle
+export {
+  leadGenBattle,
+  LEAD_GEN_PAYOUT,
+  LEAD_GEN_MAX_ATTEMPTS,
+  LEAD_GEN_TIME_LIMIT_MS,
+  type LeadGenArtifact,
+} from './lead_gen_battle.js';
+
+// Web Extraction Outcomes (OmniBridge integration)
+export {
+  type WebExtractionOutcome,
+  isWebExtractionOutcome,
+  createWebExtractionOutcome,
+  WEB_EXTRACTION_OUTCOMES,
+} from './web_extraction.js';
+
+// Swarm Planner Outcome (MVP Unified Engine)
+export {
+  swarmPlannerOutcome,
+  PLANNER_MAX_ATTEMPTS,
+  PLANNER_TIME_LIMIT_MS,
+  PLANNER_COST_CEILING,
+  PLANNER_MIN_TASKS,
+  PLANNER_MAX_TASKS,
+  PLANNER_PAYOUT_AMOUNT,
+  REQUIRED_TASK_FIELDS,
+  type PlannerTask,
+  type PlannerOutput,
+} from './swarm_planner.js';
+
+// F1 STEM OPT Compliance Checker
+export { f1StemOPTCompliance } from './f1_stem_opt_compliance.js';

package/src/outcomes/lead_gen_battle.test.ts

@@ -0,0 +1,113 @@
+/**
+ * Unit tests for Lead Gen Battle Outcome Configuration
+ *
+ * Validates that the lead gen battle outcome is properly configured
+ * with correct payout, attempts, time limits, and schema compliance.
+ *
+ * @module outcomes/lead_gen_battle.test
+ */
+
+import { describe, test, expect } from 'vitest';
+import {
+  leadGenBattle,
+  LEAD_GEN_PAYOUT,
+  LEAD_GEN_MAX_ATTEMPTS,
+  LEAD_GEN_TIME_LIMIT_MS,
+  type LeadGenArtifact,
+} from './lead_gen_battle.js';
+import { validateOutcome } from './outcome.schema.js';
+
+describe('Lead Gen Battle Outcome Configuration', () => {
+  test('has correct payout amount', () => {
+    expect(leadGenBattle.payoutAmount).toBe(1);
+    expect(leadGenBattle.payoutAmount).toBe(LEAD_GEN_PAYOUT);
+  });
+
+  test('has correct maximum attempts', () => {
+    expect(leadGenBattle.maxAttempts).toBe(10);
+    expect(leadGenBattle.maxAttempts).toBe(LEAD_GEN_MAX_ATTEMPTS);
+  });
+
+  test('has correct time limit', () => {
+    expect(leadGenBattle.timeLimitMs).toBe(60000); // 1 minute
+    expect(leadGenBattle.timeLimitMs).toBe(LEAD_GEN_TIME_LIMIT_MS);
+  });
+
+  test('validates against OutcomeSchema', () => {
+    const result = validateOutcome(leadGenBattle);
+    expect(result.valid).toBe(true);
+    expect(result.errors).toHaveLength(0);
+  });
+
+  test('has correct outcome name', () => {
+    expect(leadGenBattle.name).toBe('lead_gen_battle');
+  });
+
+  test('has descriptive description', () => {
+    expect(leadGenBattle.description).toContain('Lead Gen Precision Battle');
+    expect(leadGenBattle.description).toContain('qualified leads');
+    expect(leadGenBattle.description).toContain('valid email');
+    expect(leadGenBattle.description).toContain('LinkedIn URL');
+  });
+
+  test('has all required success criteria', () => {
+    expect(leadGenBattle.successCriteria).toHaveLength(4);
+    
+    const criteriaNames = leadGenBattle.successCriteria.map(c => c.name);
+    expect(criteriaNames).toContain('valid_email');
+    expect(criteriaNames).toContain('company_size');
+    expect(criteriaNames).toContain('valid_role');
+    expect(criteriaNames).toContain('valid_linkedin');
+  });
+
+  test('has correct validator configurations', () => {
+    const emailCriterion = leadGenBattle.successCriteria.find(c => c.name === 'valid_email');
+    expect(emailCriterion).toBeDefined();
+    expect(emailCriterion?.validator).toBe('validateEmail');
+    expect(emailCriterion?.params).toEqual({});
+
+    const companySizeCriterion = leadGenBattle.successCriteria.find(c => c.name === 'company_size');
+    expect(companySizeCriterion).toBeDefined();
+    expect(companySizeCriterion?.validator).toBe('validateCompanySize');
+    expect(companySizeCriterion?.params).toEqual({ minimum: 50 });
+
+    const roleCriterion = leadGenBattle.successCriteria.find(c => c.name === 'valid_role');
+    expect(roleCriterion).toBeDefined();
+    expect(roleCriterion?.validator).toBe('validateRole');
+    expect(roleCriterion?.params).toEqual({ excludedRoles: ['intern', 'student'] });
+
+    const linkedInCriterion = leadGenBattle.successCriteria.find(c => c.name === 'valid_linkedin');
+    expect(linkedInCriterion).toBeDefined();
+    expect(linkedInCriterion?.validator).toBe('validateLinkedIn');
+    expect(linkedInCriterion?.params).toEqual({});
+  });
+
+  test('has appropriate failure reasons', () => {
+    expect(leadGenBattle.failureReasons).toHaveLength(4);
+    expect(leadGenBattle.failureReasons).toContain('Invalid email format');
+    expect(leadGenBattle.failureReasons).toContain('Company too small - must have at least 50 employees');
+    expect(leadGenBattle.failureReasons).toContain('Invalid role - interns and students are not qualified leads');
+    expect(leadGenBattle.failureReasons).toContain('Invalid LinkedIn URL - must start with https://www.linkedin.com/in/');
+  });
+
+  test('LeadGenArtifact interface is properly typed', () => {
+    // This is a compile-time test - if it compiles, the interface is correct
+    const validArtifact: LeadGenArtifact = {
+      email: 'user@example.com',
+      companySize: 100,
+      role: 'Engineering Manager',
+      linkedIn: 'https://www.linkedin.com/in/user'
+    };
+
+    expect(typeof validArtifact.email).toBe('string');
+    expect(typeof validArtifact.companySize).toBe('number');
+    expect(typeof validArtifact.role).toBe('string');
+    expect(typeof validArtifact.linkedIn).toBe('string');
+  });
+
+  test('constants are properly exported', () => {
+    expect(LEAD_GEN_PAYOUT).toBe(1);
+    expect(LEAD_GEN_MAX_ATTEMPTS).toBe(10);
+    expect(LEAD_GEN_TIME_LIMIT_MS).toBe(60000);
+  });
+});

package/src/outcomes/lead_gen_battle.ts

@@ -0,0 +1,99 @@
+/**
+ * Lead Gen Battle Outcome
+ *
+ * Tournament Seed bounty for the WAI Championship Q1 Tournament.
+ * Agents compete to generate qualified leads with precision validation
+ * including valid email, company size, role, and LinkedIn URL.
+ *
+ * @module outcomes/lead_gen_battle
+ * @see Requirements 2.1, 2.2, 2.3, 8.2
+ */
+
+import type { Outcome } from './outcome.schema.js';
+
+/**
+ * Payout amount for successfully completing a lead gen battle.
+ * Set to $1 as per Requirements 2.1.
+ */
+export const LEAD_GEN_PAYOUT = 1;
+
+/**
+ * Maximum number of attempts an agent can make to achieve this outcome.
+ * Set to 10 as per Requirements 2.2.
+ */
+export const LEAD_GEN_MAX_ATTEMPTS = 10;
+
+/**
+ * Time limit for achieving the outcome (1 minute in milliseconds).
+ * Set to 60000ms as per Requirements 2.3.
+ */
+export const LEAD_GEN_TIME_LIMIT_MS = 60000;
+
+/**
+ * Represents a lead artifact produced by an agent.
+ * Contains all required fields for lead qualification validation.
+ */
+export interface LeadGenArtifact {
+  /** Email address of the lead (must match standard email regex) */
+  email: string;
+  /** Company size in number of employees (must be >= 50) */
+  companySize: number;
+  /** Role/title of the lead (must not be "intern" or "student") */
+  role: string;
+  /** LinkedIn profile URL (must start with "https://www.linkedin.com/in/") */
+  linkedIn: string;
+}
+
+/**
+ * Lead Gen Battle Outcome Definition
+ *
+ * Success requires meeting ALL 4 criteria:
+ * 1. Valid email format matching /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+ * 2. Company size of at least 50 employees
+ * 3. Role is not "intern" or "student" (case-insensitive)
+ * 4. LinkedIn URL starts with "https://www.linkedin.com/in/"
+ *
+ * @see Requirements 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 8.2
+ */
+export const leadGenBattle: Outcome = {
+  name: 'lead_gen_battle',
+  description:
+    'Lead Gen Precision Battle - Generate qualified leads with valid email, company size >= 50, non-student/intern role, and valid LinkedIn URL.',
+  payoutAmount: LEAD_GEN_PAYOUT,
+  maxAttempts: LEAD_GEN_MAX_ATTEMPTS,
+  timeLimitMs: LEAD_GEN_TIME_LIMIT_MS,
+  successCriteria: [
+    {
+      // Requirement 2.4: Verify email has valid syntax
+      name: 'valid_email',
+      validator: 'validateEmail',
+      params: {},
+    },
+    {
+      // Requirement 2.5: Verify company size is at least 50 employees
+      name: 'company_size',
+      validator: 'validateCompanySize',
+      params: { minimum: 50 },
+    },
+    {
+      // Requirement 2.6: Verify role is not "Student" or "Intern"
+      name: 'valid_role',
+      validator: 'validateRole',
+      params: { excludedRoles: ['intern', 'student'] },
+    },
+    {
+      // Requirement 2.7: Verify LinkedIn URL starts with correct prefix
+      name: 'valid_linkedin',
+      validator: 'validateLinkedIn',
+      params: {},
+    },
+  ],
+  failureReasons: [
+    'Invalid email format',
+    'Company too small - must have at least 50 employees',
+    'Invalid role - interns and students are not qualified leads',
+    'Invalid LinkedIn URL - must start with https://www.linkedin.com/in/',
+  ],
+};
+
+export default leadGenBattle;