# Domain Feature Inventory

Maps domain library capabilities to their web app UI components and views.

## Domain Overview

| Domain  | ID        | Status | Accent            | Primary Path          |
| ------- | --------- | ------ | ----------------- | --------------------- |
| Tara    | `tara`    | Active | Cyan `#22D3EE`    | `/meditate`           |
| Veritas | `veritas` | Active | Sky `#38BDF8`     | `/trending`           |
| Nyx     | `nyx`     | Beta   | Indigo `#818CF8`  | `/nightly-highlights` |
| Arete   | `arete`   | Active | Emerald `#34D399` | `/check-in`           |

---

## Tara (Meditation & Mindfulness)

**Surface:** `src/components/domains/TaraSurface.tsx` **Sub-components:**
`src/components/domains/tara/`

### Views

| View           | Path                    | Component               | Description                                                               |
| -------------- | ----------------------- | ----------------------- | ------------------------------------------------------------------------- |
| Home           | `/meditate`             | `TaraSurface` (default) | Dashboard: featured session, quick sessions (2/5/10 min), courses preview |
| Breathwork     | `/meditate/breathwork`  | `BreathworkTimer`       | Guided breathwork sequences with timer                                    |
| Session Player | `/meditate/session/:id` | `SessionPlayer`         | Audio playback with progress tracking                                     |
| Library        | `/meditate/library`     | `SessionLibrary`        | Browse and search meditation sessions                                     |
| Courses        | `/meditate/courses`     | `CoursesView`           | Multi-lesson course listings                                              |
| Course Detail  | `/meditate/course/:id`  | `CourseDetail`          | Individual course with lessons                                            |
| Favorites      | `/meditate/favorites`   | `FavoritesView`         | Saved meditation sessions                                                 |
| Statistics     | `/meditate/stats`       | `StatisticsView`        | Practice analytics and streaks                                            |

### Key Metrics

- Streak (days), daily time (min), weekly time (min), total sessions

### Library Features Used

- Session catalog and playback
- Breathwork sequences and timing
- Course curriculum management
- Streak and progress tracking
- Audio session management

---

## Veritas (Truth-First News & Fact-Checking)

**Surface:** `src/components/domains/VeritasSurface.tsx` **Sub-components:**
`src/components/domains/veritas/`

### Views

| View             | Path               | Component                  | Description                                           |
| ---------------- | ------------------ | -------------------------- | ----------------------------------------------------- |
| Home             | `/trending`        | `VeritasSurface` (default) | Trending verified claims, reading queue, agent status |
| Article Reader   | `/article/:id`     | `ArticleReader`            | Long-form content reading mode                        |
| Claim Checker    | `/claims`          | `ClaimChecker`             | Fact-check with confidence scoring                    |
| Bias Detector    | `/bias`            | `BiasDetector`             | Language bias analysis                                |
| Knowledge Graph  | `/knowledge-graph` | `KnowledgeGraph`           | Entity relationship visualization                     |
| Story Clusters   | `/clusters`        | `StoryClusters`            | Related articles grouped by topic                     |
| Source Directory | `/sources`         | `SourceDirectory`          | Verified source database                              |
| Reading Queue    | `/queue`           | `ReadingQueue`             | Curated articles with read-time                       |
| Topics           | `/topics`          | `TopicsView`               | Topic alerts and filters                              |
| Newsletter       | `/newsletter`      | `NewsletterView`           | Curated truth-first briefing                          |
| Agents           | `/agents`          | `AgentsView`               | AI agent pipeline status                              |
| RAG              | `/rag`             | `RAGView`                  | Research assistant with source citations              |

### Key Metrics

- Verified claims count, source count, agent task completions, reading queue
  size

### Confidence Scoring

- HIGH: >= 90% confidence
- MEDIUM: >= 75% confidence
- LOW: < 75% confidence

### Library Features Used

- Claim verification pipeline
- Source credibility database
- Bias detection algorithms
- Knowledge graph construction
- Agent orchestration pipeline
- RAG (retrieval-augmented generation)

---

## Nyx (Night Sky Observatory)

**Surface:** `src/components/domains/NyxSurface.tsx` **Sub-components:**
`src/components/domains/nyx/`

### Views

| View           | Path                  | Component              | Description                              |
| -------------- | --------------------- | ---------------------- | ---------------------------------------- |
| Home           | `/nightly-highlights` | `NyxSurface` (default) | Sky highlights, conditions, events, logs |
| Sky Map        | `/sky-map`            | `InteractiveSkyMap`    | Interactive star map with positioning    |
| Event Calendar | `/events`             | `EventCalendar`        | Upcoming celestial events                |
| Solar Activity | `/solar-activity`     | `SolarActivity`        | Real-time solar monitoring               |
| NEO Tracker    | `/neo-tracker`        | `NEOTracker`           | Near-Earth Object tracking               |
| Time Travel    | `/time-travel`        | `TimeTravel`           | Historical sky data                      |
| Education      | `/education`          | `EducationView`        | Astronomy learning resources             |
| Catalog        | `/catalog`            | `CatalogBrowser`       | Celestial object database                |
| Observations   | `/observations`       | `ObservationLog`       | Personal observation history             |
| Sonification   | `/sonification`       | `SonificationView`     | Audio representation of sky data         |
| Sky Conditions | `/sky-conditions`     | `SkyConditions`        | Local observing conditions               |

### Key Metrics

- Moon phase, sunset time, astronomical twilight, Bortle class, transparency,
  seeing quality

### Library Features Used

- Celestial coordinate calculations
- Sky map rendering and positioning
- Event prediction (meteor showers, alignments, eclipses)
- Solar activity monitoring
- NEO orbit computation
- Historical ephemeris data
- Object catalog (NGC, Messier, etc.)

---

## Arete (Personal Growth & Habit Tracking)

**Surface:** `src/components/domains/AreteSurface.tsx` **Sub-components:**
`src/components/domains/arete/`

### Views

| View            | Path            | Component                | Description                               |
| --------------- | --------------- | ------------------------ | ----------------------------------------- |
| Home            | `/check-in`     | `AreteSurface` (default) | Dashboard: progress, habits, goals, coach |
| AI Coach        | `/coach`        | `AreteCoach`             | Personalized coaching insights            |
| Habits          | `/habits`       | `AreteHabits`            | Daily habit tracking with streaks         |
| Goals           | `/goals`        | `AreteGoals`             | Goal tracking with progress bars          |
| Journal         | `/journal`      | `JournalView`            | Reflection and journaling                 |
| Gamification    | `/gamification` | `GamificationView`       | XP, badges, challenges                    |
| Balance         | `/balance`      | `BalanceView`            | Wheel of Life assessment                  |
| Affirmations    | `/affirmations` | `AffirmationsView`       | Daily positive affirmations               |
| Time Management | `/time`         | `TimeManagement`         | Pomodoro timer and time blocking          |
| Vision Board    | `/vision`       | `VisionBoard`            | Long-term goal visualization              |
| 7 Habits        | `/seven-habits` | `SevenHabits`            | Covey framework implementation            |

### Key Metrics

- Current streak (days), active habits, active goals, journal entries, mood,
  weekly completion %

### Goal Categories

- Mindfulness, Learning, Fitness, Reflection

### Library Features Used

- Habit tracking and streak computation
- Goal progress calculation
- AI coaching recommendations
- Gamification engine (XP, badges, challenges)
- Journal entry management
- Life balance assessment algorithms
- Pomodoro timer logic

---

## Cross-Domain Features

### Shared UI Patterns

All domain surfaces share these patterns:

1. **View routing** — Internal `view` state with `setView()` for sub-navigation
2. **Back navigation** — Domain back-stack context (`origin`, `stack`)
3. **Recommendations** — `useRecommendations(domainId)` for personalized content
4. **Code splitting** — Each surface is `React.lazy()` loaded with `<Suspense>`
5. **Nav state persistence** — `saveDomainNavState()` preserves scroll and path

### Domain Registry

All domain metadata is centralized in `@oshun/domain-registry`:

```typescript
interface DomainMetadata {
  id: OshunDomainId;
  name: string;
  tagline: string;
  icon: string;
  accentColor: string;
  launch: { defaultPath; quickActionPath };
  capabilities: string[];
  availability: 'active' | 'beta' | 'planned';
}
```

### Entitlements

Domain access is gated by user entitlements resolved from the user profile:

```typescript
const entitlements = resolveProfileEntitlements(profile);
// Controls which domains and features are accessible
```
