From 7a070dc309c71b785aa423e09865c13339a1a462 Mon Sep 17 00:00:00 2001 From: Paperclip Founding Engineer Date: Sun, 29 Mar 2026 09:02:10 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20=D0=BC=D0=B0=D1=82=D1=80=D0=B8=D1=86?= =?UTF-8?q?=D0=B0=20=D1=81=D0=BE=D0=B2=D0=BC=D0=B5=D1=81=D1=82=D0=B8=D0=BC?= =?UTF-8?q?=D0=BE=D1=81=D1=82=D0=B8=20CLI=20/=20skillget-manager=20/=20reg?= =?UTF-8?q?istry=20(XDE-100)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - COMPATIBILITY_MATRIX_RU.md: пин skillget-manager v0.1.4, ориентир HEAD registry, канон HTTP - docs/README.md: ссылка в индексе maintainer-доков Co-Authored-By: Paperclip Made-with: Cursor --- docs/COMPATIBILITY_MATRIX_RU.md | 25 +++++++++++++++++++++++++ docs/README.md | 1 + 2 files changed, 26 insertions(+) create mode 100644 docs/COMPATIBILITY_MATRIX_RU.md diff --git a/docs/COMPATIBILITY_MATRIX_RU.md b/docs/COMPATIBILITY_MATRIX_RU.md new file mode 100644 index 0000000..c4b1ed8 --- /dev/null +++ b/docs/COMPATIBILITY_MATRIX_RU.md @@ -0,0 +1,25 @@ +# Матрица совместимости: CLI ↔ skillget-manager ↔ registry + +Короткая сводка для мейнтейнеров: **какая комбинация версий** считается согласованной с веткой `main` этого репозитория. Подробная трассировка тикетов и артефактов — в [`ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md`](ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md) (без дублирования таблицы «тикет → репо»). + +## Зафиксированная связка на `main` (getskillpack/cli) + +| Компонент | Версия / ревизия | Где смотреть | +|-----------|------------------|--------------| +| **CLI** | ветка `main` | этот репозиторий | +| **skillget-manager** (Go module) | **v0.1.4** | [`go.mod`](../go.mod), [`go.sum`](../go.sum), каталог [`vendor/github.com/getskillpack/skillget-manager`](../vendor/github.com/getskillpack/skillget-manager) | +| **registry** (исходники контракта) | ветка `main` репозитория [getskillpack/registry](https://github.com/getskillpack/registry); ориентир последнего снятия HEAD: коммит [`b415a0e`](https://github.com/getskillpack/registry/commit/b415a0e) (2026-03-29) | канон HTTP: [`docs/registry-api.md`](https://github.com/getskillpack/registry/blob/main/docs/registry-api.md) | +| **Прод по умолчанию** | базовый URL `https://registry.skpkg.org/api/v1` | константа `defaultRegistryBase` в skillget-manager ([`config.go` в vendor](../vendor/github.com/getskillpack/skillget-manager/config.go)) | + +При смене тега/версии **skillget-manager** или после осознанного изменения **compiled core** в registry обновляйте эту таблицу и при необходимости строку в traceability-документе. + +Исторические якоря сверки контракта registry ↔ клиент (см. [XDE-90](/XDE/issues/XDE-90)): коммиты [`77ea41c`](https://github.com/getskillpack/registry/commit/77ea41c), [`1e5f26c`](https://github.com/getskillpack/registry/commit/1e5f26c) на `main` registry — для регрессионной отсылки, не как «текущий обязательный пин». + +## Канон HTTP (обязательные ссылки) + +| Роль | Документ | +|------|----------| +| Формы и маршруты API реестра (compiled core) | [`registry-api.md`](https://github.com/getskillpack/registry/blob/main/docs/registry-api.md) в **getskillpack/registry** | +| Ожидания Go-клиента (статусы, env, пути) | [`REGISTRY_CLIENT_CONTRACT.md`](https://github.com/getskillpack/skillget-manager/blob/main/docs/REGISTRY_CLIENT_CONTRACT.md) в **getskillpack/skillget-manager** | + +Краткие пользовательские ссылки на те же контракты — в [`QUICKSTART.md`](QUICKSTART.md) и [`RELEASE.md`](RELEASE.md). diff --git a/docs/README.md b/docs/README.md index 02171a8..6a05259 100644 --- a/docs/README.md +++ b/docs/README.md @@ -21,6 +21,7 @@ The files below describe org automation, tokens, cadence, and workflows. They ar | [GETSKILLPACK_GITHUB_ORG.md](GETSKILLPACK_GITHUB_ORG.md) | PAT scopes and org hygiene | | [AGENT_GITHUB_REPO_WORKFLOW_RU.md](AGENT_GITHUB_REPO_WORKFLOW_RU.md) | Agent/repo workflow (Russian) | | [ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md](ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md) | План ENGINEERING_REQUIREMENTS ↔ тикеты ↔ репо (Russian) | +| [COMPATIBILITY_MATRIX_RU.md](COMPATIBILITY_MATRIX_RU.md) | Матрица совместимости CLI / skillget-manager / registry (Russian) | | [BOARD_PAT_QUICK_RU.md](BOARD_PAT_QUICK_RU.md) | PAT setup shorthand (Russian) | | [Registry: operations runbook (RU)](https://github.com/getskillpack/registry/blob/main/docs/REFERENCE_REGISTRY_OPERATIONS_RU.md) | Prod registry hosting and maintainer operations (`getskillpack/registry`) | | [PAPERCLIP_SKILL_INSTALL_RU.md](PAPERCLIP_SKILL_INSTALL_RU.md) | Skill install runbook (Russian) |