AI LinkedIn: People search in Natural Language

const candidateProfile = {
  // Required fields for HydraDB
  id: 'candidate_123456',
  tenant_id: 'recruiting_tenant',
  sub_tenant_id: 'ml_engineering',
  title: 'Senior Machine Learning Engineer - John Smith',
  type: 'candidate_profile', // Type app identifier
  timestamp: '2024-01-15T10:30:00Z', // Profile last updated

  // Main content for AI search
  content: {
    text: `# John Smith - Senior ML Engineer

    ## Experience
    - **Apple Inc.** (3 years) - Senior ML Engineer, Siri Team
    - **StartupXYZ** (2 years) - ML Engineer, Recommendations
    - **Research Lab** (1 year) - ML Research Intern

    ## Skills
    - Machine Learning & Deep Learning
    - Python, TensorFlow, PyTorch
    - Natural Language Processing
    - Distributed Systems

    ## Education
    - MS Computer Science, Stanford University
    - BS Mathematics, UC Berkeley

    John Smith is a Senior Machine Learning Engineer with 6 years of experience in developing
    and deploying ML models at scale. He worked at Apple for 3 years on the Siri team,
    focusing on natural language processing and speech recognition. Prior to Apple, he spent
    2 years at a startup building recommendation systems. John has a Master's in Computer
    Science from Stanford and specializes in deep learning, Python, TensorFlow, and
    distributed systems. He has published 5 papers on neural networks and holds 2 patents
    in speech processing.`
  },

  // Tenant-level metadata (searchable/filterable fields defined in tenant schema)
  metadata: {
    total_years_experience: 6,
    years_at_current_role: 3,
    career_level: 'senior',
    primary_skills: ['machine_learning', 'deep_learning', 'nlp'],
    job_search_status: 'actively_looking'
  },

  // Document-specific metadata
  additional_metadata: {
    // Company history
    companies: [
      {
        name: 'Apple Inc.',
        role: 'Senior ML Engineer',
        team: 'Siri',
        duration_years: 3,
        company_size: 'large_tech',
        company_type: 'public'
      },
      {
        name: 'StartupXYZ',
        role: 'ML Engineer',
        team: 'Recommendations',
        duration_years: 2,
        company_size: 'startup',
        company_type: 'private'
      }
    ],

    // Skills and technologies
    technologies: ['python', 'tensorflow', 'pytorch', 'kubernetes'],
    programming_languages: ['python', 'java', 'scala'],

    // Education
    education: [
      {
        degree: 'Master of Science',
        field: 'Computer Science',
        institution: 'Stanford University',
        graduation_year: 2018
      }
    ],

    // Location and preferences
    location: {
      current: 'San Francisco, CA',
      willing_to_relocate: false,
      remote_preference: 'hybrid'
    },

    // Availability and preferences
    desired_salary_range: '200k-300k',
    desired_role_level: 'senior',

    // Performance indicators
    publications_count: 5,
    patents_count: 2,
    github_stars: 1250,
    conferences_spoken: 3
  },

  // Profile URL and additional info
  url: 'https://linkedin.com/in/johnsmith-ml',
  description: 'Senior ML Engineer with Apple experience, specializing in NLP and speech recognition'
};

const experienceMetadata = {
  // Quantitative experience
  total_years_experience: 6,
  years_in_current_role: 3,
  years_in_field: 6, // Different from total if career switcher
  
  // Career progression
  career_level: 'senior', // intern, junior, mid, senior, staff, principal, director
  promotion_velocity: 'fast', // slow, average, fast
  role_progression: ['engineer', 'senior_engineer'], // Career path
  
  // Management experience
  has_management_experience: false,
  team_size_managed: 0,
  years_managing: 0,
  
  // Company context
  largest_company_size: 'large_tech', // startup, small, medium, large, large_tech
  startup_experience: true,
  public_company_experience: true,
  consulting_experience: false
};

const skillsMetadata = {
  // Primary expertise areas
  primary_domains: ['machine_learning', 'artificial_intelligence'],
  secondary_domains: ['backend_development', 'data_engineering'],
  
  // Technical skills by category
  programming_languages: [
    { name: 'python', proficiency: 'expert', years: 6 },
    { name: 'java', proficiency: 'intermediate', years: 2 }
  ],
  
  frameworks_tools: [
    { name: 'tensorflow', proficiency: 'expert', years: 4 },
    { name: 'pytorch', proficiency: 'advanced', years: 3 },
    { name: 'kubernetes', proficiency: 'intermediate', years: 2 }
  ],
  
  // Specialized skills
  ai_ml_skills: ['deep_learning', 'nlp', 'computer_vision', 'reinforcement_learning'],
  cloud_platforms: ['aws', 'gcp'],
  databases: ['postgresql', 'mongodb', 'redis'],
  
  // Soft skills
  leadership_skills: ['mentoring', 'technical_leadership'],
  communication_skills: ['technical_writing', 'public_speaking'],
  
  // Certifications
  certifications: [
    { name: 'AWS Machine Learning Specialty', year: 2023 },
    { name: 'Google Cloud Professional ML Engineer', year: 2022 }
  ]
};

const educationMetadata = {
  // Formal education
  highest_degree: 'masters',
  education_institutions: [
    {
      name: 'Stanford University',
      tier: 'tier_1', // tier_1, tier_2, tier_3, other
      degree: 'MS Computer Science',
      gpa: 3.8,
      graduation_year: 2018
    }
  ],
  
  // Research and publications
  publications_count: 5,
  citation_count: 150,
  h_index: 4,
  patents_count: 2,
  
  // Open source and community
  github_contributions: 500,
  github_stars_received: 1250,
  stackoverflow_reputation: 5000,
  conferences_spoken: 3,
  
  // Awards and recognition
  awards: ['Best Paper Award ICML 2023', 'Employee of the Year Apple 2022'],
  hackathon_wins: 2,
  competition_rankings: ['Kaggle Expert']
};

const queryPatterns = {
  // Experience-based queries
  experience_queries: [
    "Find me someone who has 5+ years of experience in machine learning",
    "I need a developer with at least 3 years of React experience",
    "Show me candidates who have worked with startups for more than 2 years"
  ],
  
  // Company-based queries
  company_queries: [
    "Find candidates who worked at Apple, Google, or Microsoft",
    "Show me people who have startup experience",
    "I want someone who has worked at a Series B startup"
  ],
  
  // Skill combination queries
  skill_combination_queries: [
    "Find a full-stack developer who knows React and Node.js",
    "I need someone with ML experience and strong Python skills",
    "Show me candidates with both technical and management experience"
  ],
  
  // Transition queries
  transition_queries: [
    "Find candidates who moved from consulting to product management",
    "Show me developers who transitioned into machine learning",
    "I need someone who went from startup to big tech"
  ],
  
  // Cultural fit queries
  cultural_fit_queries: [
    "Find candidates who thrive in fast-paced environments",
    "Show me people who have built teams from scratch",
    "I need someone who has experience with remote-first companies"
  ]
};

import { HydraDBClient } from "@hydradb/sdk";

class AIRecruitingSearch {
  constructor() {
    this.client = new HydraDBClient({ token: process.env.HYDRA_DB_API_KEY });
    this.tenantId = 'linkedin-recruiter';
  }

  async findCandidates(query, recruiterContext = {}) {
    const hiringContext = this.buildHiringInstructions(recruiterContext);
    const enrichedQuery = hiringContext ? `${hiringContext}\n\n${query}` : query;

    const results = await this.client.recall.fullRecall({
      tenant_id: this.tenantId,
      query: enrichedQuery,

      // Hiring-specific configurations
      max_results: 20, // More candidates for review
      mode: 'thinking', // Multi-query with reranking for better results

      // Search tuning for candidate discovery
      alpha: 0.6, // Favor semantic understanding
      recency_bias: 0.2 // Don't heavily favor recent profiles
    });

    return this.enhanceCandidateResults(results, query);
  }

  buildHiringInstructions(recruiterContext) {
    let instructions = `You are helping a recruiter find the best candidates. `;
    
    if (recruiterContext.role) {
      instructions += `They are looking to fill a ${recruiterContext.role} position. `;
    }
    
    if (recruiterContext.company) {
      instructions += `The role is at ${recruiterContext.company}. `;
    }
    
    if (recruiterContext.teamSize) {
      instructions += `The team size is ${recruiterContext.teamSize}. `;
    }
    
    instructions += `Focus on candidate fit, experience relevance, and potential for success. 
                    Highlight why each candidate would be a good match. 
                    Consider both hard skills and soft skills. 
                    Rank candidates by overall fit for the role.`;
    
    return instructions;
  }

  enhanceCandidateResults(results, originalQuery) {
    if (!results.chunks) return results;

    // Add hiring-specific analysis to each candidate
    const enhancedSources = results.chunks.map(candidate => ({
      ...candidate,
      fit_score: this.calculateFitScore(candidate, originalQuery),
      strengths: this.extractStrengths(candidate),
      potential_concerns: this.extractConcerns(candidate),
      interview_questions: this.suggestInterviewQuestions(candidate, originalQuery)
    }));

    // Sort by fit score
    enhancedSources.sort((a, b) => b.fit_score - a.fit_score);

    return {
      ...results,
      chunks: enhancedSources,
      search_insights: this.generateSearchInsights(enhancedSources, originalQuery)
    };
  }

  extractStrengths(candidate) {
    const strengths = [];
    const meta = candidate.metadata || {};
    if (meta.total_years_experience >= 5) strengths.push("Extensive experience");
    if (meta.publications_count > 0) strengths.push("Published researcher");
    if (meta.career_level === "senior" || meta.career_level === "staff") strengths.push("Senior-level contributor");
    if ((meta.companies || []).some(c => c.company_size === "large_tech")) strengths.push("Big-tech background");
    if (meta.has_management_experience) strengths.push("Proven leadership");
    return strengths;
  }

  extractConcerns(candidate) {
    const concerns = [];
    const meta = candidate.metadata || {};
    if (meta.total_years_experience < 3) concerns.push("Limited experience — verify depth of role");
    if ((meta.companies || []).every(c => c.company_size === "large_tech")) {
      concerns.push("No startup experience — assess adaptability");
    }
    if (meta.job_search_status === "passively_looking") concerns.push("Not actively searching — expect longer close cycle");
    return concerns;
  }

  suggestInterviewQuestions(candidate, query) {
    const questions = [];
    const meta = candidate.metadata || {};
    if ((meta.companies || []).length > 0) {
      questions.push(`Walk me through your most impactful project at ${meta.companies[0].name}.`);
    }
    if (query.toLowerCase().includes("machine learning") || (meta.primary_skills || []).includes("machine_learning")) {
      questions.push("Describe a model you shipped end-to-end — from data to production monitoring.");
    }
    if (meta.has_management_experience) {
      questions.push("Tell me about a time you had to let someone go. How did you handle it?");
    }
    questions.push("What does your ideal engineering culture look like?");
    return questions;
  }

  generateSearchInsights(candidates, query) {
    const avgYears = candidates.reduce((sum, c) => sum + (c.metadata?.total_years_experience || 0), 0) / (candidates.length || 1);
    const topCompanies = [...new Set(
      candidates.flatMap(c => (c.metadata?.companies || []).map(co => co.name))
    )].slice(0, 5);
    return {
      total_candidates: candidates.length,
      average_experience_years: Math.round(avgYears * 10) / 10,
      top_company_backgrounds: topCompanies,
      query_summary: query.slice(0, 120)
    };
  }

  calculateFitScore(candidate, query) {
    // Simple scoring algorithm - in practice, you'd use more sophisticated ML
    let score = 0;
    
    // Experience relevance
    if (candidate.metadata?.total_years_experience) {
      const years = candidate.metadata.total_years_experience;
      if (query.includes('5+') && years >= 5) score += 30;
      if (query.includes('3+') && years >= 3) score += 25;
      if (query.includes('senior') && years >= 5) score += 20;
    }
    
    // Company match
    const queryLower = query.toLowerCase();
    if (candidate.metadata?.companies) {
      candidate.metadata.companies.forEach(company => {
        if (queryLower.includes(company.name.toLowerCase())) {
          score += 25;
        }
      });
    }
    
    // Skill relevance (simplified)
    if (candidate.metadata?.primary_skills) {
      const skills = candidate.metadata.primary_skills;
      if (queryLower.includes('machine learning') && skills.includes('machine_learning')) {
        score += 20;
      }
    }
    
    return Math.min(score, 100); // Cap at 100
  }
}

const recruiterMemoryProfile = {
  // Search preferences
  search_patterns: {
    preferred_experience_levels: ['senior', 'staff'],
    frequently_searched_skills: ['react', 'nodejs', 'typescript'],
    preferred_company_types: ['startup', 'scale_up'],
    typical_salary_ranges: ['150k-250k'],
    location_preferences: ['san_francisco', 'remote']
  },
  
  // Successful hire patterns
  successful_hires: {
    common_backgrounds: ['apple', 'google', 'meta'],
    effective_skill_combinations: [
      ['react', 'nodejs', 'aws'],
      ['python', 'machine_learning', 'tensorflow']
    ],
    preferred_career_progressions: ['ic_to_senior_ic', 'startup_to_growth'],
    successful_education_backgrounds: ['computer_science', 'engineering']
  },
  
  // Team and role context
  hiring_context: {
    team_type: 'engineering',
    company_stage: 'series_b',
    team_size: 15,
    remote_policy: 'hybrid',
    common_interview_topics: ['system_design', 'coding', 'culture_fit']
  },
  
  // Communication preferences
  interaction_style: {
    detail_level: 'comprehensive', // brief, moderate, comprehensive
    preferred_format: 'structured_list',
    wants_interview_questions: true,
    wants_salary_insights: true
  }
};

class PersonalizedRecruitingSearch extends AIRecruitingSearch {
  async searchWithPersonalization(query, recruiterId, jobContext = {}) {
    // AI memories are automatically managed by HydraDB when we provide user_name
    const personalizedContext = {
      sessionId: await this.getRecruiterSessionId(recruiterId),
      recruiterId: recruiterId, // Enables automatic AI memory management
      ...jobContext
    };

    const results = await this.findCandidates(query, personalizedContext);
    
    // Add personalized insights based on recruiter's history
    return this.addPersonalizedInsights(results, recruiterId);
  }

  async addPersonalizedInsights(results, recruiterId) {
    // Get recruiter's AI memory context (managed automatically by HydraDB)
    const recruiterProfile = await this.getRecruiterProfile(recruiterId);
    
    const personalizedResults = {
      ...results,
      personalized_insights: {
        recommended_candidates: this.getRecommendedCandidates(results.chunks, recruiterProfile),
        similar_to_past_hires: this.findSimilarToPastHires(results.chunks, recruiterProfile),
        interview_suggestions: this.generatePersonalizedInterviewQuestions(results.chunks, recruiterProfile),
        salary_insights: this.generateSalaryInsights(results.chunks, recruiterProfile)
      }
    };

    return personalizedResults;
  }

  getRecommendedCandidates(candidates, recruiterProfile) {
    return candidates
      .filter(candidate => {
        // Check if candidate matches recruiter's successful hire patterns
        const companies = candidate.metadata?.companies?.map(c => c.name.toLowerCase()) || [];
        const skills = candidate.metadata?.primary_skills || [];
        
        // Match against successful hire patterns
        const hasSuccessfulCompanyBackground = companies.some(company => 
          recruiterProfile.successful_hires?.common_backgrounds?.includes(company)
        );
        
        const hasPreferredSkills = skills.some(skill => 
          recruiterProfile.search_patterns?.frequently_searched_skills?.includes(skill)
        );
        
        return hasSuccessfulCompanyBackground || hasPreferredSkills;
      })
      .slice(0, 5); // Top 5 recommendations
  }

  generatePersonalizedInterviewQuestions(candidates, recruiterProfile) {
    const questions = [];
    
    candidates.slice(0, 3).forEach(candidate => {
      const candidateQuestions = [];
      
      // Generate questions based on candidate's experience
      if (candidate.metadata?.companies) {
        candidate.metadata.companies.forEach(company => {
          candidateQuestions.push(
            `Tell me about your experience at ${company.name} and how it relates to our ${recruiterProfile.hiring_context?.team_type} team.`
          );
        });
      }
      
      // Add technical questions based on recruiter's preferences
      if (recruiterProfile.hiring_context?.common_interview_topics?.includes('system_design')) {
        candidateQuestions.push(
          "Can you walk me through how you'd design a system to handle [specific use case relevant to the role]?"
        );
      }
      
      questions.push({
        candidate_name: candidate.title?.split(' - ')[1] || 'Candidate',
        candidate_id: candidate.id,
        suggested_questions: candidateQuestions
      });
    });
    
    return questions;
  }
}

Recruiter Query: "Find me a senior React developer with startup experience"

Basic Results:
- 15 candidates with React experience
- Generic ranking by keyword match
- No context about recruiter preferences

Recruiter Query: "Find me a senior React developer with startup experience"

AI-Enhanced Results:
- Prioritizes candidates from Series A/B startups (learned preference)
- Highlights candidates with Node.js experience (frequently paired skill)
- Suggests candidates with 4-6 years experience (recruiter's sweet spot)
- Includes salary expectations matching recruiter's budget
- Recommends candidates with remote experience (company is remote-first)

AI Memory Insights:
"Based on your previous successful hires, I'm highlighting candidates who:
- Have experience at high-growth startups like your previous hires from Stripe and Airbnb
- Combine React with Node.js and TypeScript (your most successful tech stack combination)
- Are in the 4-6 year experience range where you've had the highest offer acceptance rate"

const complexQueries = [
  {
    query: "Find me someone who has 5+ years of experience in machine learning and has worked at Apple before",
    breakdown: {
      experience_requirement: "5+ years",
      domain_requirement: "machine learning", 
      company_requirement: "Apple",
      additional_context: "Looking for proven ML expertise with big tech experience"
    }
  },
  
  {
    query: "I need a senior frontend developer who has experience scaling React applications at a startup and can lead a team",
    breakdown: {
      seniority: "senior",
      technical_skills: "React, frontend development",
      scaling_experience: "applications at scale",
      company_context: "startup",
      leadership_requirement: "team leadership"
    }
  },
  
  {
    query: "Show me candidates who transitioned from consulting to product management at a tech company and have an MBA",
    breakdown: {
      career_transition: "consulting → product management",
      industry_context: "tech company",
      education_requirement: "MBA",
      career_narrative: "Career switcher with business education"
    }
  }
];

class AdvancedCandidateSearch extends PersonalizedRecruitingSearch {
  async searchWithComplexCriteria(query, criteria = {}) {
    const {
      experienceRange,
      requiredSkills,
      preferredCompanies,
      salaryRange,
      locationRequirements,
      educationLevel,
      availabilityStatus
    } = criteria;

    // Build metadata filter for hard requirements
    const metadataFilter = {};
    
    if (experienceRange) {
      metadataFilter.min_years_experience = experienceRange.min;
      metadataFilter.max_years_experience = experienceRange.max;
    }
    
    if (availabilityStatus) {
      metadataFilter.job_search_status = availabilityStatus;
    }

    // Use natural language query for soft requirements and context
    const enhancedQuery = this.enhanceQueryWithContext(query, criteria);

    const results = await this.findCandidates(enhancedQuery, {
      additionalContext: this.buildAdvancedInstructions(criteria)
    });

    return this.rankByComplexCriteria(results, criteria);
  }

  enhanceQueryWithContext(originalQuery, criteria) {
    let enhancedQuery = originalQuery;
    
    if (criteria.teamContext) {
      enhancedQuery += ` for a ${criteria.teamContext.size}-person ${criteria.teamContext.type} team`;
    }
    
    if (criteria.companyContext) {
      enhancedQuery += ` at a ${criteria.companyContext.stage} ${criteria.companyContext.industry} company`;
    }
    
    if (criteria.urgency) {
      enhancedQuery += `. This is a ${criteria.urgency} priority hire`;
    }
    
    return enhancedQuery;
  }

  buildAdvancedInstructions(criteria) {
    let instructions = "Find candidates who best match these requirements:\n";
    
    if (criteria.mustHave) {
      instructions += `Must have: ${criteria.mustHave.join(', ')}\n`;
    }
    
    if (criteria.niceToHave) {
      instructions += `Nice to have: ${criteria.niceToHave.join(', ')}\n`;
    }
    
    if (criteria.dealBreakers) {
      instructions += `Avoid candidates with: ${criteria.dealBreakers.join(', ')}\n`;
    }
    
    instructions += "Rank candidates by overall fit, considering both technical skills and cultural alignment.";
    
    return instructions;
  }
}

Search: "Machine Learning Engineer Apple"
Results: Only candidates with exact terms "Machine Learning" AND "Apple"
Missed: 
- "ML Engineer at Apple" (ML != Machine Learning)
- "Data Scientist at Apple who built ML models"
- "AI Engineer at Apple working on neural networks"
- "Software Engineer at Apple, Siri team, NLP focus"

Search: "Find me someone who has 5+ years of experience in machine learning and has worked at Apple before"
AI Understanding:
- "machine learning" includes: ML, AI, neural networks, deep learning, data science
- "worked at Apple" includes: current and former employees, contractors, interns
- "5+ years" considers: total experience, relevant experience, progressive experience
- Context understanding: Looking for proven ML expertise with big tech credibility

Enhanced Results:
✓ "Senior AI Engineer at Apple, 6 years in deep learning"
✓ "Data Scientist, former Apple ML intern, 5 years total ML experience"  
✓ "ML Engineer who worked on Siri team for 2 years, 6 years total ML"
✓ "Research Scientist at Apple AI/ML, PhD + 4 years industry experience"

class IntelligentCandidateRanking {
  rankCandidates(candidates, searchContext) {
    return candidates.map(candidate => {
      const scores = {
        experience_fit: this.scoreExperienceFit(candidate, searchContext),
        skill_relevance: this.scoreSkillRelevance(candidate, searchContext),
        company_prestige: this.scoreCompanyBackground(candidate, searchContext),
        career_trajectory: this.scoreCareerTrajectory(candidate, searchContext),
        cultural_fit: this.scoreCulturalFit(candidate, searchContext),
        availability: this.scoreAvailability(candidate, searchContext)
      };
      
      const overallScore = this.calculateWeightedScore(scores, searchContext.weights);
      
      return {
        ...candidate,
        ranking_scores: scores,
        overall_fit_score: overallScore,
        ranking_explanation: this.generateRankingExplanation(scores, candidate)
      };
    }).sort((a, b) => b.overall_fit_score - a.overall_fit_score);
  }

  scoreExperienceFit(candidate, context) {
    const years = candidate.metadata?.total_years_experience || 0;
    const required = context.experience_requirements || {};
    
    // Perfect match scoring
    if (required.min && years >= required.min) {
      const overQualified = required.max && years > required.max * 1.5;
      return overQualified ? 70 : 100; // Slight penalty for over-qualification
    }
    
    // Partial match scoring
    if (required.min && years >= required.min * 0.8) {
      return 60; // Close to requirement
    }
    
    return 20; // Significantly under-qualified
  }

  generateRankingExplanation(scores, candidate) {
    const explanations = [];
    
    if (scores.experience_fit > 80) {
      explanations.push("Strong experience match for the role requirements");
    }
    
    if (scores.company_prestige > 80) {
      explanations.push("Impressive company background that adds credibility");
    }
    
    if (scores.skill_relevance > 90) {
      explanations.push("Excellent technical skill alignment");
    }
    
    if (scores.career_trajectory > 85) {
      explanations.push("Demonstrated career growth and progression");
    }
    
    return explanations.join("; ");
  }
}

Recruiter Query: "Find me a senior full-stack developer who has experience building scalable web applications at a growth-stage startup"

AI Understanding:
- Role: Senior full-stack developer
- Technical requirement: Scalable web applications
- Company context: Growth-stage startup
- Implied skills: Frontend, backend, scaling challenges
- Implied experience: 5+ years, startup environment

Metadata Filtering:
- career_level: 'senior'
- company_types: ['startup', 'scale_up']
- technical_domains: ['web_development', 'full_stack']
- scaling_experience: true

Top Results:
1. Sarah Chen - Senior Full-Stack Engineer at Stripe (Series C)
   - 6 years experience, React/Node.js expert
   - Built payment processing system handling 1M+ transactions/day
   - Previous startup experience at seed-stage company
   - Fit Score: 95% - "Perfect match for growth-stage technical challenges"

2. Mike Rodriguez - Lead Developer at Notion (Series B)
   - 7 years experience, TypeScript/Python specialist  
   - Architected real-time collaboration features for millions of users
   - Early employee (#15) who scaled with company growth
   - Fit Score: 92% - "Proven experience scaling web apps in growth environment"

Recruiter Query: "I need an engineering manager who transitioned from individual contributor and has experience growing teams at a tech company"

AI Understanding:
- Role: Engineering manager
- Career path: IC → Manager transition
- Skill: Team building and growth
- Industry: Tech company
- Leadership style: Grown with teams

Enhanced Analysis:
The AI identifies candidates who:
- Started as engineers and moved into management
- Have experience hiring and growing teams
- Understand technical challenges from IC perspective
- Work at tech companies with engineering culture

Top Results:
1. David Park - Engineering Manager at Airbnb
   - IC for 4 years → Manager for 3 years
   - Grew team from 3 to 15 engineers
   - Still codes 20% of time, maintains technical credibility
   - Fit Score: 94% - "Classic IC-to-manager transition with proven team growth"

2. Jessica Liu - Senior Engineering Manager at Slack
   - Frontend engineer for 5 years → Manager for 2 years
   - Built hiring process that scaled team 300%
   - Known for developing junior engineers into senior roles
   - Fit Score: 89% - "Strong developer background with team development focus"

Recruiter Query: "Show me machine learning engineers who have experience with recommendation systems and have worked with large-scale data at a consumer internet company"

AI Understanding:
- Domain: Machine learning
- Specialization: Recommendation systems
- Scale requirement: Large-scale data
- Industry: Consumer internet
- Implied technologies: ML pipelines, data processing, personalization

Advanced Matching:
The AI connects related concepts:
- "Recommendation systems" includes: personalization, ranking, collaborative filtering
- "Large-scale data" includes: big data, distributed systems, real-time processing
- "Consumer internet" includes: social media, e-commerce, streaming, search

Top Results:
1. Alex Kim - Senior ML Engineer at Netflix
   - 5 years building recommendation algorithms
   - Handles 500M+ user interactions daily
   - Expert in collaborative filtering and deep learning
   - Published papers on large-scale recommendation systems
   - Fit Score: 98% - "Perfect domain expertise with proven large-scale impact"

2. Priya Patel - ML Engineer at Spotify
   - 4 years in music recommendation and discovery
   - Built real-time personalization for 400M+ users
   - Experience with A/B testing recommendation algorithms
   - Background in both content and collaborative filtering
   - Fit Score: 95% - "Strong recommendation system expertise in consumer domain"

class AIInterviewPrep {
  generatePersonalizedQuestions(candidate, role, recruiterHistory) {
    const questions = {
      technical_questions: this.generateTechnicalQuestions(candidate, role),
      behavioral_questions: this.generateBehavioralQuestions(candidate, role),
      company_specific: this.generateCompanyQuestions(candidate, recruiterHistory),
      red_flag_exploration: this.generateRedFlagQuestions(candidate)
    };

    return {
      ...questions,
      interview_strategy: this.generateInterviewStrategy(candidate, role),
      key_areas_to_explore: this.identifyKeyAreas(candidate, role)
    };
  }

  generateTechnicalQuestions(candidate, role) {
    const questions = [];
    
    // Questions based on candidate's specific experience
    if (candidate.metadata?.companies) {
      candidate.metadata.companies.forEach(company => {
        if (company.name === 'Apple' && role.includes('ML')) {
          questions.push(
            "At Apple, you worked on the Siri team. Can you walk me through how you approached the challenge of improving speech recognition accuracy while maintaining low latency?"
          );
        }
      });
    }

    // Technology-specific questions
    if (candidate.metadata?.technologies?.includes('tensorflow')) {
      questions.push(
        "I see you have extensive TensorFlow experience. How would you design a training pipeline for a model that needs to process real-time data streams?"
      );
    }

    return questions;
  }

  generateInterviewStrategy(candidate, role) {
    const strategy = {
      focus_areas: [],
      potential_concerns: [],
      selling_points: [],
      follow_up_areas: []
    };

    // Analyze candidate strengths and gaps
    if (candidate.metadata?.total_years_experience < role.min_experience) {
      strategy.potential_concerns.push("Experience level slightly below target - explore depth of experience");
      strategy.focus_areas.push("Deep dive into specific projects and impact");
    }

    if (candidate.metadata?.companies?.some(c => c.company_size === 'large_tech')) {
      strategy.selling_points.push("Highlight startup agility and impact potential");
      strategy.follow_up_areas.push("Understand motivation for startup environment");
    }

    return strategy;
  }
}

const recommendedCandidateFields = {
  // Core identification (Required by HydraDB)
  id: "unique_candidate_identifier",
  tenant_id: "recruiting_tenant",
  sub_tenant_id: "ml_engineering",
  title: "Descriptive candidate title with name and role",
  type: "candidate_profile", // Type app identifier
  timestamp: "2024-01-01T00:00:00Z", // Profile last updated

  // Rich content for AI understanding (Critical for good search)
  content: {
    text: `## Professional Summary
               ## Experience History
               ## Technical Skills
               ## Education & Certifications
               ## Key Achievements

               Comprehensive narrative covering:
               - Current role and responsibilities
               - Key achievements and quantified impact
               - Technology stack and expertise areas
               - Company context and team dynamics
               - Career progression and major transitions
               - Notable projects and their business impact
               - Leadership experience and team building
               - Industry recognition and community involvement`
  },

  // Tenant-level metadata (searchable/filterable fields defined in tenant schema)
  metadata: {
    total_years_experience: 6,
    years_in_current_role: 2,
    career_level: "senior",
    primary_skills: ["machine_learning", "python", "tensorflow"],
    secondary_skills: ["data_engineering", "aws", "kubernetes"]
  },

  // Document-specific metadata
  additional_metadata: {
    // Company history with context
    companies: [
      {
        name: "Apple Inc.",
        role: "Senior ML Engineer",
        team: "Siri",
        duration_years: 3,
        company_stage: "public",
        company_size: "large_tech"
      }
    ],

    // Performance indicators
    impact_metrics: {
      team_size_managed: 0,
      products_shipped: 5,
      users_impacted: 1000000,
      revenue_impact: "10M+",
      publications: 3,
      patents: 1
    }
  }
};

const searchStrategy = {
  // Start broad, then narrow
  initial_search: "Find me machine learning engineers with 5+ years experience",
  
  // Add company context
  refined_search: "Find me machine learning engineers with 5+ years experience who have worked at tech companies",
  
  // Add specific requirements  
  targeted_search: "Find me senior machine learning engineers with 5+ years experience who have worked at Apple, Google, or similar tech companies and have deep learning expertise",
  
  // Add cultural/team fit
  final_search: "Find me senior machine learning engineers with 5+ years experience who have worked at Apple, Google, or similar tech companies, have deep learning expertise, and have experience mentoring junior engineers in a fast-paced environment"
};

const optimizationTips = {
  // Batch candidate uploads for efficiency
  upload_strategy: {
    batch_size: 20, // Max 20 candidates per batch
    interval_between_batches: 1000, // 1 second between batches
    // verify: always call POST /ingestion/verify_processing after upload
  },
  
  // Cache frequent searches
  caching_strategy: {
    cache_duration: "5 minutes",
    cache_popular_queries: true,
    invalidate_on_new_candidates: true
  },
  
  // Optimize for recruiter workflows
  workflow_optimization: {
    save_search_filters: true,
    enable_search_alerts: true,
    batch_candidate_review: true
  }
};

const hiringMetrics = {
  // Search quality metrics
  search_effectiveness: {
    relevant_results_percentage: 85, // % of results marked as relevant
    average_time_to_find_candidate: "15 minutes", // vs. 2+ hours traditional
    queries_per_successful_hire: 3.2 // vs. 15+ traditional
  },
  
  // Recruiter productivity
  recruiter_efficiency: {
    candidates_reviewed_per_hour: 12, // vs. 4 traditional
    interviews_scheduled_per_week: 8, // vs. 3 traditional
    time_saved_per_search: "45 minutes"
  },
  
  // Hiring quality
  hire_quality: {
    offer_acceptance_rate: 78, // Higher due to better matching
    new_hire_performance_rating: 4.2, // /5 scale
    hiring_manager_satisfaction: 92 // % satisfied with candidates
  },
  
  // AI-specific metrics
  ai_adoption: {
    natural_language_query_usage: 89, // % of searches using NL
    ai_suggestion_acceptance: 67, // % of AI recommendations followed
    personalization_engagement: 84 // % finding personalized results helpful
  }
};