microdao-daarion/docs/runbooks/CLAN_ZHOS_STACK.md

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

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

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.