# CLAN ZHOS Stack (Existing Architecture + Add-ons)

## Що вже інтегровано

1. Оновлено системний промт CLAN:
   - `gateway-bot/clan_prompt.txt`
2. Додано ZHOS-профіль сабагентів у CrewAI:
   - `config/crewai_teams.yml` -> `clan.profiles.zhos_mvp`
3. Додано промти ролей:
   - `config/roles/clan/zhos/*.md`

## Мінімальні додаткові сервіси (без ламання ядра)

1. `clan-consent-adapter` (порт `8111`)
   - Consent Event, Testimony Draft
   - Локальна SQLite, опційний Bearer API key
2. `clan-visibility-guard` (порт `8112`)
   - перевірка downgrade видимості
   - класифікація чутливості
   - безпечна редукція тексту для нижчих рівнів

## OpenAPI контракти

1. `docs/contracts/clan-consent-adapter.openapi.yaml`
2. `docs/contracts/clan-visibility-guard.openapi.yaml`

## Compose-фрагмент

1. `docs/runbooks/CLAN_ZHOS_COMPOSE_FRAGMENT.yml`

Локальний запуск:

```bash
docker compose -f docker-compose.node1.yml -f docs/runbooks/CLAN_ZHOS_COMPOSE_FRAGMENT.yml up -d --build clan-consent-adapter clan-visibility-guard
```

## Рекомендація активації

1. Залишити `clan.default_profile=default` для безпечного rollout.
2. Увімкнути `zhos_mvp` тільки для CLAN-трафіку, який пройшов smoke tests.
3. Після перевірки можна переключити default_profile на `zhos_mvp`.
