docs: add node1 runbooks, consolidation artifacts, and maintenance scripts

This commit is contained in:
Apple
2026-02-19 00:14:27 -08:00
parent c57e6ed96b
commit 544874d952
586 changed files with 14065 additions and 22 deletions

View 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`.