Sync remaining docs with CLI surface, Assistent, and Civitai dataset.

Align architecture/cli/decisions with modules and Debug API; cross-link seed overlays and scrape→FTS so user docs match 0.2.0.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/cli.md

@@ -51,6 +51,7 @@ gpu-rent up --yes --ollama
 
 | Команда | Поведение |
 | --- | --- |
+| `gpu-rent version` | Версия пакета (`0.2.0`) |
 | `gpu-rent setup` | Wizard: манифесты (в т.ч. ollama-models), `LLM_RUNTIME` (нумерованное меню), пресет, опционально local-watchdog |
 | `gpu-rent doctor` | Preflight **без** create. Exit ≠ 0 → сессию начинать нельзя |
 | `gpu-rent flavors` | Скан `SCAN_POOLS` по сегментам a/b/c × `FLAVOR_PREFERENCE` × `FLAVOR_SIZE_PRESET`, список в текущем регионе |
@@ -62,6 +63,7 @@ gpu-rent up --yes --ollama
 | `gpu-rent up --ollama` / `--llm ollama` | Ollama рядом со SwarmUI |
 | `gpu-rent up --no-swarm` / `--llm-only` | Только Ollama (нужен `--ollama` / `LLM_RUNTIME=ollama`); без clone SwarmUI |
 | `gpu-rent up --no-update` | Без `git pull` SwarmUI/extensions (только недостающие clone) |
+| `gpu-rent up --update` | Форс `git pull` SwarmUI + extensions (перекрывает `UPDATE_GIT=false`) |
 | `gpu-rent up --no-tunnel` | Только облако |
 | `gpu-rent up --no-spot` | Не preemptible |
 | `gpu-rent up --flavor ID --yes` | Явный flavor; без `--flavor` + `--yes` — первый доступный из `FLAVOR_PREFERENCE` |
@@ -73,11 +75,11 @@ gpu-rent up --yes --ollama
 | `gpu-rent hold` / `--minutes N` / `--until ISO` / `--clear` | Пауза idle-killer (нужны живая VM + SSH) |
 | `gpu-rent stop` / `stop --no-pull` | Удалить compute (+ FIP), диски оставить; optional pull Output |
 | `gpu-rent destroy --i-understand-data-loss` | `stop` + диски |
-| `gpu-rent logs` | journalctl swarmui / cloud-init (полный дамп; после `up` хвост уже печатается сам) |
+| `gpu-rent logs` / `logs -u UNIT` | journalctl на VM; `-u swarm\|ollama\|killer\|cloud-init` (алиас `ollama` → юнит `gpu-rent-ollama`) |
 | `gpu-rent ssh` | Оболочка на VM |
 | `gpu-rent seed-models` | Докачать новые строки Civitai-манифеста на живой диск |
 | `gpu-rent seed-extensions` | Доклонировать/обновить git-репы; restart swarmui |
-| `gpu-rent seed-personas` | Пуш `assistent-personas/` → overlay на VM (без полного up) |
+| `gpu-rent seed-personas` | Пуш `assistent-personas/` → overlay на VM (без полного up); также `search.jsonl` → FTS, если есть |
 | `gpu-rent push` / `push-models` | Локальные деревья → VM |
 | `gpu-rent pull-output` | VM `Output/` → `./Output` |
 | `gpu-rent capture` / `capture all` | Инвентарь VM → merge **ссылок** в `models.yaml` + `extensions.yaml` (веса не качать) |
@@ -92,6 +94,19 @@ gpu-rent up --yes --ollama
 
 Нет команды `generate`. Локальный SwarmUI целиком не зеркалируем — только папки приложения ([local-folders.md](local-folders.md)).
 
+### Отдельный CLI: `civitai-dataset` (не Typer)
+
+Лаунчеры `civitai-dataset.bat` / `.ps1` / `.sh` → `python -m gpu_rent.civitai_dataset`. По умолчанию `all`. Подробности и пути: [datasets/README.md](../datasets/README.md).
+
+| Команда | Поведение |
+| --- | --- |
+| `discover` | Топ Krea2 checkpoints/LoRAs → `catalog/models.json` |
+| `scrape` | Галереи (метаданные, **без** картинок); `--target`, `--per-version`, `--min-score` |
+| `split` | `by_kind/` / `by_rating/` / `train.jsonl` / `search.jsonl` |
+| `all` | discover + scrape + split |
+
+Нужен `CIVITAI_API_TOKEN` (лучше `CIVITAI_API_HOST=civitai.red`). На `up` / `seed-personas` файл `datasets/civitai/search.jsonl` пушится на VM как `Assistent/civitai-examples.jsonl` (если есть).
+
 ---
 
 ## `doctor`
@@ -103,12 +118,13 @@ gpu-rent up --yes --ollama
 1. Читается `.env`, обязательные `OS_*`
 2. Keystone выдаёт токен
 3. Квота GPU > 0 (иначе текст про поддержку Selectel)
-4. В сегменте есть flavor из `FLAVOR_PREFERENCE`
+4. В сегменте есть flavor из `FLAVOR_PREFERENCE` / `DEFAULT_FLAVOR_ID`
 5. Volume type / место под data ~100 GB
 6. SSH-ключ есть или будет создан в `.gpu-rent/`
-7. Если есть `CIVITAI_API_TOKEN` — доступ к API-хосту; манифест парсится
-8. `extensions.yaml` парсится, если есть
-9. Предупреждения по огромным локальным `Models/`
+7. Живой сервер с тегом `gpu-rent` (info) и boot snapshot `gpu-rent-boot-ok` (info)
+8. Если есть `CIVITAI_API_TOKEN` — доступ к API-хосту; манифест парсится
+9. `extensions.yaml` парсится, если есть; при `LLM_RUNTIME=ollama` — `ollama-models.yaml` + строка Assistent ext
+10. Предупреждения по огромным локальным `Models/`
 
 Exit 0 → можно `up`. Exit 1 → причина в таблице / кратком списке на `up`.
 
@@ -140,6 +156,7 @@ Exit 0 → можно `up`. Exit 1 → причина в таблице / кра
 | `/assistent/memory` | `assistent.sqlite` + counts |
 | `/assistent/api` | `AssistentListPersonas/Models/Memory/Chats` через туннель (или SSH) |
 | `/assistent/api?chat_smoke=1` | + 1-token Ollama `/api/chat` (кратко грузит модель) |
+| `/assistent/wanted` | **GET** — очередь wanted-моделей на data volume |
 | `/assistent/logs` | journalctl swarmui: build/load/Sqlite |
 | `/assistent?logs=1` | Сводка + journal |
 | `/assistent/session` | **POST** — multi-turn debug chat (in-memory, TTL ~45m) |
@@ -258,6 +275,9 @@ BOOT_SNAPSHOT_NAME=gpu-rent-boot-ok
 
 CIVITAI_API_TOKEN=
 CIVITAI_API_HOST=civitai.red
+# HF для download/capture (любой из двух):
+# HF_TOKEN=
+# HUGGING_FACE_HUB_TOKEN=
 MODELS_MANIFEST=
 LOCAL_MODELS_DIR=
 LOCAL_WILDCARDS_DIR=
@@ -272,6 +292,7 @@ SWARMUI_LOCAL_PORT=17801
 LLM_RUNTIME=none
 OLLAMA_LOCAL_PORT=17811
 DEBUG_LOCAL_PORT=17821
+# ENABLE_SWARMUI=false / WORKLOAD=llm — только LLM (см. llm.md)
 UPDATE_GIT=true
 
 DEFAULT_FLAVOR_ID=
@@ -286,6 +307,11 @@ IDLE_GRACE_MINUTES=45
 # LOCAL_WATCHDOG_GRACE_MINUTES=10
 PULL_OUTPUT=false
 NOTIFY_READY=true
+
+# Баланс ₽ (X-Token панели, не OS_*). Нужен watchdog install:
+# SELECTEL_API_TOKEN=
+# BALANCE_NOTIFY_STEP_RUB=200
+# BALANCE_NOTIFY_LOW_RUB=
 ```
 
 Flavor uuid в git не хардкодить. `FLAVOR_FALLBACK=false` — только `DEFAULT_FLAVOR_ID` / `--flavor`.