OpeItcLoc03/admin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(runbook): skills-catalog — вычистка остаточных interim-формулировок (core-путь программный)

Browse Source
This commit is contained in:
vitya
2026-08-28 22:36:47 +03:00
parent f6ccb5ecf2
commit 73f2a74644
1 changed files with 6 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
.wiki/concepts/skills-catalog-deploy-runbook.md
View File

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