HR Onboarding

await kairn.souls.create({
  name: 'onboarding',
  label: 'Onboarding Guide',
  soulMd: `
    You are an onboarding guide for new employees joining the company.

    Your job:
    - Answer questions about company policies, tools, and processes
    - Guide the new hire through their first-week checklist
    - Help them understand their role, team structure, and who to contact
    - Make them feel welcomed and supported

    Behaviour rules:
    - Use the employee's name (from memory) when greeting them
    - Reference their specific role and team when relevant
    - Track checklist progress in memory — update keys when tasks are completed
    - If you don't know something specific, direct them to their manager or HR contact
    - Keep a friendly, encouraging tone — starting a new job is stressful

    First-week checklist items (track completion in memory):
    - it_setup: laptop, accounts, email configured
    - team_intro: met their immediate team
    - tools_setup: Slack, Notion, GitHub/Jira access confirmed
    - first_1on1: first 1:1 with manager scheduled
    - culture_docs: read company handbook and values doc
    - payroll: banking details submitted to HR
  `,
  defaultModel: 'anthropic/claude-sonnet-4-6',
})

async function onboardEmployee(employeeId: string) {
  const employee = await hrSystem.getEmployee(employeeId)
  const team     = await hrSystem.getTeam(employee.teamId)
  const manager  = await hrSystem.getUser(employee.managerId)

  await kairn.memory.set(employeeId, 'default', {
    name:         employee.firstName,
    full_name:    employee.fullName,
    role:         employee.jobTitle,
    department:   employee.department,
    start_date:   employee.startDate,
    team_name:    team.name,
    team_size:    String(team.memberCount),
    manager_name: manager.name,
    manager_email: manager.email,
    hr_contact:   'hr@company.com',

    // Checklist — all pending at start
    it_setup:     'pending',
    team_intro:   'pending',
    tools_setup:  'pending',
    first_1on1:   'pending',
    culture_docs: 'pending',
    payroll:      'pending',
  })

  // Daily nudge — runs 9am Mon-Fri
  await kairn.mandates.create({
    userId: employeeId,
    soul: 'onboarding',
    label: 'Daily onboarding check-in',
    taskPrompt: `
      Check the employee's onboarding checklist progress in memory.
      Identify which items are still pending.
      Write a brief encouraging note to memory under "daily_nudge"
      reminding them of the next pending item to complete.
      If all items are done, write "onboarding_complete: true" to memory.
    `,
    trigger: {
      type: 'cron',
      cron: '0 9 * * 1-5',
    },
  })
}

// GET /api/onboarding/status
export async function getOnboardingStatus(employeeId: string) {
  const memory = await kairn.memory.get(employeeId, 'default')

  const checklist = [
    { key: 'it_setup',     label: 'IT setup (laptop, accounts, email)' },
    { key: 'team_intro',   label: 'Meet your team' },
    { key: 'tools_setup',  label: 'Tools access (Slack, Notion, etc.)' },
    { key: 'first_1on1',   label: 'Schedule first 1:1 with manager' },
    { key: 'culture_docs', label: 'Read company handbook' },
    { key: 'payroll',      label: 'Submit payroll details' },
  ]

  return {
    employeeName:  memory.name,
    role:          memory.role,
    startDate:     memory.start_date,
    managerName:   memory.manager_name,
    checklist:     checklist.map(item => ({
      ...item,
      status: memory[item.key] ?? 'pending',
    })),
    completionPct: Math.round(
      checklist.filter(i => memory[i.key] === 'done').length / checklist.length * 100
    ),
    todaysNudge: memory.daily_nudge ?? null,
  }
}

export function OnboardingAssistant({ employeeId }: { employeeId: string }) {
  return (
    <div className="onboarding-assistant">
      <div className="assistant-header">
        <h3>Your Onboarding Guide</h3>
        <p>Ask me anything about your first week, the company, or your team.</p>
      </div>
      <AgentChat
        employeeId={employeeId}
        agentName="onboarding"
        sessionId={`onboarding_${employeeId}`}
        placeholder="What's on the agenda for today?"
      />
    </div>
  )
}