docs(runbook): skills-catalog — вычистка остаточных interim-формулировок (core-путь программный)
This commit is contained in:
@@ -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):** если в плане есть
|
||||
`~ <name> (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 +
|
||||
|
||||
Reference in New Issue
Block a user