chore(wiki): F&F round concept sched-admin-client-openapi + task close

.wiki/concepts/sched-admin-client-openapi.md

@@ -0,0 +1,56 @@
+---
+title: sched admin-client openapi — F&F раунд 2026-08-18
+type: concept
+tags: [sched, ff, openapi, admin-api, python, codegen, f&f-round]
+related: [[openapi-generator-3-1-spec-gotchas]], [[sched-fnf-r8-verification-stand]]
+updated: 2026-08-18
+---
+
+# sched admin-client openapi — F&F раунд
+
+Живая проверка claim'а sched openapi-spec: **«клиент на любом ЯП одной
+командой»**. Вердикт: **claim подтверждён с оговорками** — генерация одной
+командой работает, но 3.1-спека до «любого ЯП без правок» не дотягивает
+(8 операций требуют raw-обхода).
+
+## Что делал / ожидал / получил
+
+| | |
+|---|---|
+| Что | Python-клиент из опубликованной спеки `@sched/admin-api/openapi.json` 0.1.2 (verdaccio subpath-export, идентична репо), `openapi-generator` 7.24.0 (`-g python`, JDK 25) |
+| Ожидал | типизированная десериализация всех ответов, зелёный сьют, зелёный smoke |
+| Получил | сьют **24/24** (3 прогона), smoke **19/19**, все 15 путей/21 операция живые — НО клиент в сыром виде падает на 8 операциях (pydantic ValidationError) из-за пробелов спеки; обход — `raw_ops.py` (сгенерированный пакет не тронут) |
+
+## Deliverables
+
+- **Код**: `sched/examples/admin-client-python/` — коммит `e89e868` (запушен):
+  `openapi.json` (пин 0.1.2), `generate.ps1` (одна команда), `sched_admin_client/`
+  (сгенерированный, checked-in), `tests/` (TDD 24/24), `smoke.py` (19/19),
+  `raw_ops.py` (обход), `README.md` (F&F-таблица по всем путям).
+- **Репорт**: `sched/.agents/inbox/2026-08-18T19-15-43Z-admin-fnf-openapi-client-report.md`
+  (F&F-формат: что→ожидал→получил→дока+гладкое).
+- **Таска**: `[sched-admin-client-openapi]` 🟢 закрыта 2026-08-18.
+
+## Находки (в репорт, спеку НЕ чинил — импл sched, TDD)
+
+- **F-1** `/health`: спека `security: []`, daemon с ключом 401-ит даже health (письменный стенд :8080 непригоден для безключевых клиентов).
+- **F-2 (главный)** mutation-ответы `{}` вместо `{task/run/schedule:…}` → генераторы врут; объявить схемы ответов.
+- **F-3** `const: true` → строковый enum `('true')` ломает boolean.
+- **F-4** oneOf+discriminator `Schedule` → `actual_instance=None`, контент только через raw JSON.
+- **F-5** top-level `dedupKey` в POST /schedules молча игнорится (ключ — внутри `schedule`).
+- Механика генераторных граблей — [[openapi-generator-3-1-spec-gotchas]].
+
+## Как повторить
+
+```powershell
+cd sched/examples/admin-client-python
+$env:JAVA_HOME = "C:\Program Files\Eclipse Adoptium\jdk-25.0.2.10-hotspot"
+.\generate.ps1
+pip install -r requirements.txt pytest
+SCHED_ADMIN_URL=http://127.0.0.1:8127/api python -m pytest tests/ -v
+python smoke.py --url http://127.0.0.1:8127/api
+```
+
+Стенд раунда: published `@sched/daemon` 0.3.4, `--admin-port 8127`, NO AUTH,
+scratch sqlite (`/tmp/sched-acpy-stand/acpy.db`). Письменный `:8080` — под ключом
+(`SCHED_ADMIN_KEY=dev-key`), `:8123` — стейл-билд (health 0.1.8, нет POST /tasks).

.wiki/index.md

@@ -21,6 +21,7 @@ Catalog of all wiki pages. One line per page, organized by type. Updated on ever
 - [windows-recovery-host](entities/windows-recovery-host.md) — Windows Recovery Host (рабочий PC пользователя)
 
 ## Concepts
+- [sched-admin-client-openapi](concepts/sched-admin-client-openapi.md) — F&F раунд 2026-08-18: Python-клиент одной командой из спеки (openapi-generator 7.24.0), 24/24 + smoke 19/19, вердикт «claim подтверждён с оговорками», находки F-1..F-5
 - [openapi-generator-3-1-spec-gotchas](concepts/openapi-generator-3-1-spec-gotchas.md) — генерация клиентов из 3.1-спеки (openapi-generator 7.24.0, python): ответы `{}` + wrapped-тело → ValidationError (raw-обход + by_alias), `const:true` → строковый enum, oneOf+discriminator → actual_instance=None, Java 11+, Windows excluded-порты
 - [nvm-junction-ismain-gate-gotcha](concepts/nvm-junction-ismain-gate-gotcha.md) — ESM isMain-гейт молча не выполняется под junction'нутым npm-рутом (nvm/mise/volta); realpath-фикс; диагностика за 30 сек
 - [nvm-windows-node-switch](concepts/nvm-windows-node-switch.md) — смена версии Node на nvm-windows: junction, per-version глобалы, PATH-кэш, npm 11 allow-scripts; Node 22→24 evidence

.wiki/log.md

@@ -136,3 +136,4 @@ Append-only log of wiki operations (ingests, promotions, lints, migrations).
 ## [2026-08-18] ingest | UPDATE concepts/sched-fnf-r8-verification-stand.md — сессия №4/№5: admin-api-test.mjs (52/52, F1 tz-hoist + F3 PATCH-merge подтверждены на core 0.40.2), UI-стенд ui-backend.mjs + sched-ui serve :8081 + браузерный CDP (13/13), находки U1 (форма-tz interval/once → 400) и U2 (таблица шире контейнера ~58px). index.md hook обновлён.
 ## [2026-08-18] ingest | NEW concepts/nvm-junction-ismain-gate-gotcha.md — ESM isMain-гейт молча no-op под junction-префиксом npm-рута (C:\nvm4w\nodejs → realpath …\nvm\v22.22.0): import.meta.url резолвится в realpath, argv[1] держит литеральный → main() не выполняется, exit 0. Бьёт global-install под любым version-manager'ом (nvm/mise/volta). Фикс realpath-сравнения (sched bd38aab, daemon 0.3.2). NEW concepts/nvm-windows-node-switch.md — Node 22→24.19.0 рецепт: junction-свап, per-version глобалы, PATH-кэш shell'а, npm 11 allow-scripts. Оба из сессии CLI-F&F sched 2026-08-18. index.md updated (+2).
 ## [2026-08-18] ingest | NEW concepts/openapi-generator-3-1-spec-gotchas.md — из F&F openapi-client sched (2026-08-18): генерация Python-клиента из 3.1-спеки openapi-generator 7.24.0. Гочи: (1) ответы `{}` в спеке + wrapped-тело ({task/run/schedule:…}) → pydantic ValidationError, фикс — реальные схемы ответов, обход raw-транспорт + by_alias=True; (2) `const:true` → строковый enum ('true') ломает boolean; (3) oneOf+discriminator → actual_instance=None, контент только через raw JSON; Java 11+ обязателен (системная 8 падает), Windows excluded-порты 8090/8091 (EACCES), консоль cp1251 без →/«». Полные находки F-1..F-5: sched/.agents/inbox репорт 19:15Z; пример sched/examples/admin-client-python (24/24). index.md updated.
+## [2026-08-18] ingest | NEW concepts/sched-admin-client-openapi.md — F&F раунд openapi-claim sched (по предписанию таски): Python-клиент одной командой (openapi-generator 7.24.0 из спеки verdaccio 0.1.2), сьют 24/24 + smoke 19/19 против published daemon 0.3.4 (:8127), вердикт «claim подтверждён с оговорками» (8 операций требуют raw-обхода). Код sched/examples/admin-client-python (e89e868), репорт — sched инбокс 19:15Z, находки F-1..F-5 (спеку не чинил). Таска [sched-admin-client-openapi] 🟢. Гочи генерации — concepts/openapi-generator-3-1-spec-gotchas.md. index.md updated.