# Aletheia Lab OS — Документація

## Огляд

Aletheia (Алетейя) — міждисциплінарний дослідницький агент та операційна система лабораторії в екосистемі DAARION.

**Над-мета:** "Міст між епохами" — виявляти приховану істину та пропонувати рішення, що спрощують та гармонізують.

---

## Ментор

**Олександр Вертій "Алвєр"**
- Telegram: @archenvis
- Email: alverjob@gmail.com
- Сайт: https://alverjob.xyz
- YouTube: https://www.youtube.com/@alverjob72

**Робочі канали:**
- Канал: https://t.me/alverjob
- Чат: https://t.me/alverjob_chat

---

## Архітектура

### Режими автономності

| Режим | Опис | Дозволи |
|-------|------|---------|
| **A0** | Advisory only | Тільки консультації, без зовнішніх дій |
| **A1** | Assisted | Зовнішні дії після підтвердження користувача |
| **A2** | Controlled autonomy | Автономні дії в межах BudgetPolicy |

### Субагенти (CrewAI "professors")

1. **Prof-Erudite** — пошук, верифікація, аналогії
2. **Prof-Analyst** — декомпозиція, TRIZ, формалізація
3. **Prof-Creative** — латеральні ідеї, провокації
4. **Prof-Optimizer** — реалізовність, мінімальність
5. **Prof-Communicator** — синтез, комунікація

---

## JSON-схеми

Розташування: `/opt/microdao-daarion/schemas/aletheia/`

| Схема | Призначення |
|-------|-------------|
| `intent.schema.json` | Внутрішнє представлення наміру |
| `action.schema.json` | Зовнішня дія з Policy Gate |
| `ledger_entry.schema.json` | Запис в журнал аудиту |
| `budget_policy.schema.json` | Політика бюджету та дозволів |

---

## Core Loop

```
1. Interpret → Intent JSON
2. Clarify → Уточнення (1-3 питання)
3. Plan → План + очікувані виходи
4. Delegate → Запити до субагентів
5. Decide → Відповідь / Action JSON
6. Log → LedgerEntry (для зовнішніх дій)
7. Reflect → Оновлення евристик
```

---

## Policy Gate

Кожна зовнішня дія перевіряється на:
- clarity_ok — чіткість наміру
- risk_ok — прийнятний рівень ризику
- budget_ok — відповідність бюджету
- permission_ok — дозволи режиму
- target_ok — валідна ціль
- privacy_ok — захист приватності
- rate_limit_ok — в межах лімітів
- logging_ok — можливість аудиту

---

## Multimodal

- **Фото:** vision-моделі, OCR, технічні креслення
- **Документи:** PDF, DOCX, Excel → RAG
- **Голос:** STT вже інтегровано

---

## Інтеграції

- **DAARWIZZ:** Координація R&D задач
- **DAARION:** Memory Service, Router, NATS
- **Helion:** Спільні енергетичні дослідження
- **Nutra:** Колаборація по біотех

---

## Приклад використання

**Запит:** "Оптимізувати процес екстракції"

**Aletheia:**
1. Стабілізує запит (уточнює що/як/критерії)
2. Залучає Prof-Analyst для TRIZ-аналізу
3. Залучає Prof-Creative для альтернатив
4. Prof-Optimizer оцінює реалізовність
5. Prof-Communicator формує відповідь

---

*Версія: 2.0 | Дата: 2026-01-28*
