docs: add node1 runbooks, consolidation artifacts, and maintenance scripts
This commit is contained in:
41
docs/runbooks/CLAN_ZHOS_STACK.md
Normal file
41
docs/runbooks/CLAN_ZHOS_STACK.md
Normal file
@@ -0,0 +1,41 @@
|
||||
# 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`.
|
||||
Reference in New Issue
Block a user