# AI Teacher Personality Registry

The metaverse AI guide system now exposes a registry of 120+ distinct teacher
personalities that extend the existing archetype foundation with concrete
regions, modalities, and specialisations.

## Overview

- `TeacherPersonalityRegistry` combines every archetype from
  `TeacherArchetypeFactory` with three practitioner styles (Lineage Keeper,
  Modern Bridge, Integration Mentor) to generate 123 unique personalities.
- Each personality carries explicit metadata: region, focus, modalities,
  signature practices, language coverage, voice profile, and recommended student
  cohorts.
- Registries hook into the integrated `AIConsciousnessGuideSystem`, providing
  personality lookups alongside deep personality models, multimodal
  communication, and lineage authenticity.

## Usage

```ts
import {
  TeacherPersonalityRegistry,
  TeacherArchetypeFactory,
} from '@lilith/metaverse/ai/teachers';

const archetypes = new TeacherArchetypeFactory();
const registry = new TeacherPersonalityRegistry({
  archetypeFactory: archetypes,
});

const allGuides = registry.getAllPersonalities();
const tibetanMentors = registry.getPersonalitiesByTradition('tibetan');
const breathworkSpecialists = registry.getPersonalitiesByModality('breathwork');

console.log(registry.getPersonalityCount()); // 123
console.log(tibetanMentors[0].displayName); // e.g. "Dzogchen Master · Lineage Keeper"
```

## Summary data

```ts
const summary = registry.getSummary();

summary.total; // >= 120
summary.byCategory.spiritual; // >= 45
summary.languages; // unique language coverage (14+ entries)
summary.modalities; // modality popularity map
```

## Integration

`AIConsciousnessGuideSystem` now exposes `teacherPersonalityRegistry`, enabling
downstream features to select concrete guides for sessions, retreats, or digital
cohorts without rebuilding archetype logic.

## Testing

Targeted Jest coverage keeps the persona library deterministic:

```bash
cd services/metaverse
timeout -k 5 30000 env NODE_OPTIONS='--experimental-vm-modules' \
  npx jest --runTestsByPath tests/ai/teachers/TeacherPersonalityRegistry.test.ts
```
