diff --git a/.wiki/concepts/skills-catalog-deploy-runbook.md b/.wiki/concepts/skills-catalog-deploy-runbook.md index 4009972..0e6c6db 100644 --- a/.wiki/concepts/skills-catalog-deploy-runbook.md +++ b/.wiki/concepts/skills-catalog-deploy-runbook.md @@ -37,7 +37,7 @@ updated: 2026-08-28 - `https://git.kzntsv.site/victor/mappa-vitya-skills.git` - SSH-порт git.kzntsv.site — **2222** (не 22). - **Endpoint:** `https://mappa.vds.kzntsv.site/skills` — GET (список), GET `/skills/:name`, - POST (create). PATCH/DELETE для `kind=core` → **403 (immutable)**. + POST (create). PATCH core — с source=admin (1466 live); DELETE core — 403. - **Токен:** `MAPPA_API_TOKEN` — `<из pass mappa/full-env>` (тот же, что env 3/3 стека mappa). - **Deploy-скрипт (task:1461 done):** `scripts/deploy-catalog.mjs` в каждом каталоге-репо (синк изменений вместо oneshot-засева seed-skills.ts, task:1448; kind по имени репо @@ -58,14 +58,13 @@ updated: 2026-08-28 ```bash node scripts/deploy-catalog.mjs --dry-run # дефолт тоже dry-run ``` - Сверить план: `create` / `update` / `immutable (!)` / `up-to-date` — нет ли - неожиданного (лишний create = чужой каталог; immutable = правка core). + Сверить план: `create` / `update` / `up-to-date` (core-правки помечаются + `(core, source=admin)`) — нет ли неожиданного (лишний create = чужой каталог). 3. **Apply:** ```bash node scripts/deploy-catalog.mjs --apply ``` - Применяет create + update (**methodology** PATCH). Изменённый **core** — - `! immutable`, НЕ применяется (см. interim, п.4). + Применяет create + update (PATCH; core — с source=admin, см. п.4). 4. **core-обновление (программный путь, 1466 live с 0.30.0):** если в плане есть `~ (core, source=admin)` — правки core применяются PATCH-ом (source=admin, event-аудит skill.core_update). Ручной шаг НЕ нужен. DELETE core — по-прежнему 403 @@ -96,8 +95,8 @@ updated: 2026-08-28 - `GET https://mappa.vds.kzntsv.site/skills` (с `MAPPA_API_TOKEN`) — затронутые скилы присутствуют, `version` актуальна (из frontmatter SKILL.md), `enabled:true`. -- Прогон без ошибок: created/updated без 4xx/5xx (ошибки → в письме); methodology — - PATCH применён; изменённый core — остался без применения (interim, зафиксировать в письме). +- Прогон без ошибок: created/updated без 4xx/5xx (ошибки → в письме); PATCH применён + (в т.ч. core — source=admin). - Потребительская сторона: `sync-skills.ts` подхватит обновления на дисках харнессов (после `/reload`, спека wiki:3300 п.11) — verify-контур, не часть деплоя. - **База (первый прогон 2026-08-28 после деплоя 0.30.0):** mappa-skills — 8 up-to-date +