docs(platform): add policy configs, runbooks, ops scripts and platform documentation

Config policies (16 files): alert_routing, architecture_pressure, backlog,
cost_weights, data_governance, incident_escalation, incident_intelligence,
network_allowlist, nodes_registry, observability_sources, rbac_tools_matrix,
release_gate, risk_attribution, risk_policy, slo_policy, tool_limits, tools_rollout

Ops (22 files): Caddyfile, calendar compose, grafana voice dashboard,
deployments/incidents logs, runbooks for alerts/audit/backlog/incidents/sofiia/voice,
cron jobs, scripts (alert_triage, audit_cleanup, migrate_*, governance, schedule),
task_registry, voice alerts/ha/latency/policy

Docs (30+ files): HUMANIZED_STEPAN v2.7-v3 changelogs and runbooks,
NODA1/NODA2 status and setup, audit index and traces, backlog, incident,
supervisor, tools, voice, opencode, release, risk, aistalk, spacebot

Made-with: Cursor
This commit is contained in:
Apple
2026-03-03 07:14:53 -08:00
parent 129e4ea1fc
commit 67225a39fa
102 changed files with 20060 additions and 0 deletions

98
docs/spacebot/README.md Normal file
View File

@@ -0,0 +1,98 @@
# Spacebot — Sofiia Telegram Agent
Spacebot — це Rust-based multi-agent framework від Spacedrive. Використовується як Telegram-фронтенд для агента Sofiia в екосистемі DAARION.
- GitHub: https://github.com/spacedriveapp/spacebot
- Версія: v0.1.15
- Telegram bot: @SofiiaDaarionbot
## Архітектура
```
[Telegram] ←→ [Spacebot (Rust)] ←→ [GLM-5 / Grok 4.1]
LanceDB (vector memory)
SOUL.md / IDENTITY.md / USER.md
```
## Встановлення (перший раз)
### Залежності
```bash
brew install rust protobuf cmake
curl -fsSL https://bun.sh/install | bash
```
### Збірка з вихідного коду
```bash
git clone --depth=1 https://github.com/spacedriveapp/spacebot.git ~/github-projects/spacebot
cd ~/github-projects/spacebot
cargo build --release # ~7-20 хвилин
```
### Конфіг
```bash
mkdir -p ~/.spacebot
cp docs/spacebot/config.toml.example ~/.spacebot/config.toml
# Відредагуй ~/.spacebot/config.toml — виправ модель і ключі якщо потрібно
```
Ключі зберігаються в `.env` проекту:
- `SOFIIA_TELEGRAM_BOT_TOKEN` — токен бота @SofiiaDaarionbot
- `ZHIPU_API_KEY` / `GLM5_API_KEY` — GLM-5 (Zhipu AI)
- `XAI_API_KEY` — Grok (xAI), fallback
### Ідентичність агента
Файли в `~/.spacebot/agents/sofiia/workspace/`:
- `IDENTITY.md` — хто такий агент, контекст DAARION, засновник
- `SOUL.md` — стиль спілкування, мова, межі
- `USER.md` — інформація про Повелителя Хаосу / Іван Титар
## Управління
```bash
# Запуск
./ops/scripts/start_spacebot.sh start
# Статус
./ops/scripts/start_spacebot.sh status
# Live логи
./ops/scripts/start_spacebot.sh logs
# Перезапуск (після змін конфігу або identity файлів)
./ops/scripts/start_spacebot.sh restart
# Зупинка
./ops/scripts/start_spacebot.sh stop
```
## Важливо перед запуском
Якщо бот раніше використовував webhook (наприклад через gateway.daarion.city), треба видалити його:
```bash
source .env
curl "https://api.telegram.org/bot${SOFIIA_TELEGRAM_BOT_TOKEN}/deleteWebhook?drop_pending_updates=true"
```
## Моделі (поточні)
| Призначення | Модель | Provider |
|-------------|--------|----------|
| channel (чат) | glm-5 | Zhipu AI |
| branch (задачі) | glm-5 | Zhipu AI |
| worker (фон) | glm-4.5-air | Zhipu AI |
| cortex (память) | glm-4.7 | Zhipu AI |
| fallback | grok-4-1 / grok-4-1-mini | xAI |
## Де логи
```
~/.spacebot/logs/spacebot.log.YYYY-MM-DD
~/.spacebot/agents/sofiia/ — workspace, memory, lancedb
```