s-installerkit 0.1.0__tar.gz

s_installerkit-0.1.0/.gitignore

@@ -0,0 +1,47 @@
+# === atlas universal gitignore ===
+
+# OS / IDE
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Sensitive
+.env
+.env.local
+*.key
+*.pem
+secrets/
+private/
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+
+# Node / JS
+node_modules/
+.next/
+dist/
+build/
+
+# Temporary / large
+*.log
+*.tmp
+nul
+NUL
+*.zip
+*.rar
+*.7z
+
+# Media (selectively unignore via !path/*.ext if needed for fixtures)
+*.mp4
+*.mov
+*.avi
+*.mkv

s_installerkit-0.1.0/AGENTS.md

@@ -0,0 +1,45 @@
+# AGENTS.md — s-installerkit
+
+> Контекст для AI-ассистентов (Claude Code, ChatGPT, Cursor и т.п.), работающих
+> над этим проектом.
+
+## Что это
+
+Универсальный installer-kit: uv-bootstrap, self-update (модель skillery), генератор install-скриптов, прямая регистрация навыка + публикация в skillery. Тонкий слой над s-skillkit+clikit+librarykit.
+
+## Atlas
+
+Проект зарегистрирован в Atlas-БД (Atlas). Карточка:
+
+```sh
+atlas projects get s-installerkit
+```
+
+Любые изменения метаданных (приоритет, статус, теги) — через atlas CLI:
+
+- `atlas projects update s-installerkit --priority P0` — поменять приоритет
+- `atlas add-tags s-installerkit -t domain:<slug>` — добавить тег
+- `atlas projects move s-installerkit --to-type <type>` — конвертировать тип
+
+## Тип / Статус (на момент создания)
+
+- type=`kit`, status=`experiment`, priority=`P1`
+
+## Правила работы
+
+- Все исходные тексты, документы, код проекта — в этом репо.
+- Чувствительные данные (`.env`, токены, ключи) — игнорируются `.gitignore`.
+- AI-ассистенту разрешено: читать, генерировать, редактировать в этом репо.
+
+## Канонические команды
+
+- `atlas projects get s-installerkit` — карточка проекта
+- `atlas task list --project s-installerkit` — задачи проекта (когда W7
+  волна будет реализована)
+
+<!-- atlas:usage:start -->
+## Управление проектом — через Atlas
+
+Этот проект ведётся в Atlas (личная PM-система портфеля). Для задач/проектов/эпиков/бэкапов
+используй CLI `atlas` и вызывай навык `atlas` — вся логика и роутинг внутри навыка.
+<!-- atlas:usage:end -->

s_installerkit-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.5
+Name: s-installerkit
+Version: 0.1.0
+Summary: Универсальный установщик/self-update CLI-продуктов: uv-bootstrap, self-update (PyPI JSON API), генератор ASCII install-скриптов. Тонкий слой над s-skillkit.
+Author: Dmitry
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: s-clikit
+Requires-Dist: s-librarykit
+Requires-Dist: s-skillgate
+Requires-Dist: s-skillkit
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# s-installerkit
+
+> Универсальный installer-kit: uv-bootstrap, self-update (модель skillery), генератор install-скриптов, прямая регистрация навыка + публикация в skillery. Тонкий слой над s-skillkit+clikit+librarykit.
+
+## Что это
+
+Тонкий верхний слой над **s-skillkit**: даёт CLI-продукту установку и
+самообновление «под ключ», НЕ дублируя механику skillkit (`ensure_uv`,
+`bootstrap_skill`, manifest, линковка навыка — импортируются из него).
+
+Dist-имя — `s-installerkit`; имя для импорта — `installerkit`.
+
+```bash
+uv add s-installerkit
+```
+
+## Публичный API
+
+```python
+from installerkit import (
+    configure, InstallerConfig,   # единая конфигурация (прокси на skillkit + dist-имя)
+    make_self_update_command,     # фабрика clikit-команды `self-update` (PyPI)
+    render_install_script,        # генератор ASCII bootstrap-скриптов (sh/ps1)
+    ensure_uv, run_doctor,        # окружение продукта: uv + scripts/self_check.py
+    install_direct,               # прямая установка навыка (линковка + bootstrap)
+    publish_to_store,             # публикация в skillery-store (с секрет-гейтом)
+    run_publish_gate,             # секрет-скан + денилист (gitleaks + s-skillgate)
+    build_publish_payload,        # payload POST /skills по манифесту навыка
+)
+```
+
+Кит ставит и CLI `installer`:
+
+```bash
+installer install <путь-к-навыку> [--scope global|project] [--all-agents]
+installer ensure-uv
+installer doctor <каталог-продукта> [--no-self-check]
+installer publish <путь-к-навыку> --tag v1.2.3 [--dry-run] [--force]
+```
+
+- **`configure(InstallerConfig(app_name, dist_name, ...))`** — идемпотентно
+  проецирует брендинг/каталоги на `skillkit.configure` и запоминает `dist_name`
+  для self-update. Каталоги — ленивыми провайдерами (кит env сам не читает).
+- **`make_self_update_command(dist_name)`** → clikit-команда: сверяет версию с
+  PyPI JSON API (`pypi.org/pypi/<dist>/json`), обновляет авто-детектом менеджера
+  (`uv tool` / `pipx` / `pip`), `--check` — только показать. На Windows апгрейд —
+  detached-процессом (launcher `.exe` залочен), применяется со след. запуска.
+  Регистрация: `app.command(name="self-update")(make_self_update_command("s-myctl"))`.
+- **`render_install_script("sh"|"ps1", dist_name, cli_name)`** → строка
+  ASCII-only bootstrap-скрипта (ставит `uv` при отсутствии → `uv tool install
+  --upgrade <dist>`). ASCII гарантируется (иначе `curl|sh` / `irm|iex` ломаются).
+- **`install_direct(path, scope=..., all_agents=...)`** — прямой путь установки
+  (без хаба): материализует навык в центральный стор и линкует
+  junction/symlink'ом в `~/.claude/skills/<slug>` (или в project-scope), гоняет
+  `skillkit.bootstrap_skill` (ensure_uv → deps → бинари → self_check), для
+  `kind = "tooling"` регистрирует MCP-серверы у агента. Возвращает
+  graceful-отчёт `{ok, slug, agents, bootstrap, mcp, errors}` и НЕ бросает;
+  битая ссылка в scope детектится (`link_status = "broken"`).
+- **`ensure_uv()`** — идемпотентно найти/поставить `uv`:
+  `{"uv": <путь|None>, "status": "found" | "installed" | "missing"}`. `found` —
+  uv уже был и ничего не делалось.
+- **`run_doctor(product_dir)`** — сводная проверка окружения продукта: uv, `.venv`,
+  наличие и прогон `scripts/self_check.py`. Возвращает
+  `{ok, uv, venv, self_check_script, self_check, problems}`, не бросает;
+  `installer doctor` печатает отчёт и выходит с кодом 1, если `ok=False`.
+- **`publish_to_store(path, tag=..., client=...)`** — публикация навыка:
+  сначала ГЕЙТ (`run_publish_gate`: gitleaks, если бинарь есть в PATH, плюс
+  `s-skillgate` — regex-секреты и денилист внутренней инфы), затем сборка
+  манифеста (`kind`/`cli`/`mcp`/`runtime_dependencies` — без них хаб не
+  поставит сам инструмент), затем отправка через `client.publish_skill(payload)`
+  (sync и async-клиенты оба). Блокирующие находки → `CliError`
+  (`publish_gate_failed`, exit 1) ДО сборки и сети; `force=True` — сознательный
+  обход. `dry_run=True` возвращает payload, не отправляя (секретные поля в нём
+  замаскированы). Транспорта кит не несёт — клиент инъектирует потребитель;
+  команда `installer publish` без клиента умеет `--dry-run`.
+- Команда `installer publish` закрыта правом **`skill.publish`**: если задан
+  env `INSTALLER_PERMISSIONS`, она регистрируется только при наличии права.
+
+## Контракт `scripts/self_check.py` (самопроверка продукта)
+
+Финальный gate установки: его гоняет и `skillkit.bootstrap_skill`, и
+`installer doctor`. Продукт обязан положить скрипт по пути
+`scripts/self_check.py` в своём корне.
+
+- **Вход**: аргументов нет, stdin не читается (запуск неинтерактивный).
+  Рабочий каталог — корень продукта; интерпретатор выбирается в порядке
+  `<продукт>/.venv/bin/python` → `uv run python` → текущий `sys.executable`.
+- **Выход**: человекочитаемый отчёт в stdout/stderr (оба потока попадают в
+  `self_check.output`). Формат свободный; пишите, ЧТО именно не так.
+- **Коды возврата**: `0` — окружение исправно; **любой ненулевой** — нет
+  (различать 1/2/3 инсталлятор не станет, коды нужны только вашим тестам).
+- **Ограничения**: без сети и без секретов в выводе; таймаут 300 с (skillkit
+  убьёт зависший скрипт). Скрипта нет ⇒ это САМО ПО СЕБЕ проблема:
+  подтвердить окружение нечем, `doctor` вернёт `ok=False`.
+
+```python
+# scripts/self_check.py
+import shutil, sys
+
+problems = [] if shutil.which("uv") else ["нет uv в PATH"]
+print("
+".join(problems) or "окружение исправно")
+sys.exit(1 if problems else 0)
+```
+
+## Разработка
+
+```bash
+uv sync --extra dev
+uv run --extra dev pytest -q
+uv run --extra dev ruff check installerkit tests
+```
+
+## Статус
+
+- **Type**: `kit`
+- **Status**: `experiment`
+- **Priority**: P1
+- **Slug**: `s-installerkit`
+- **Prefix**: `si`
+- **Tags**: —
+- Создан: 2026-07-17
+
+## Atlas
+
+Карточка проекта в Atlas-БД (Atlas):
+
+```sh
+atlas projects get s-installerkit
+```
+
+Физический layout:
+
+- Storage: `_storage/s-installerkit/`
+- Junction: `Products\s-installerkit` → `_storage/s-installerkit`
+
+## TODO (placeholder)
+
+- [ ] Заполнить README реальным контентом проекта.
+- [ ] Подключить GitLab-репозиторий (если ещё нет): `atlas projects git init s-installerkit`.

s_installerkit-0.1.0/README.md

@@ -0,0 +1,140 @@
+# s-installerkit
+
+> Универсальный installer-kit: uv-bootstrap, self-update (модель skillery), генератор install-скриптов, прямая регистрация навыка + публикация в skillery. Тонкий слой над s-skillkit+clikit+librarykit.
+
+## Что это
+
+Тонкий верхний слой над **s-skillkit**: даёт CLI-продукту установку и
+самообновление «под ключ», НЕ дублируя механику skillkit (`ensure_uv`,
+`bootstrap_skill`, manifest, линковка навыка — импортируются из него).
+
+Dist-имя — `s-installerkit`; имя для импорта — `installerkit`.
+
+```bash
+uv add s-installerkit
+```
+
+## Публичный API
+
+```python
+from installerkit import (
+    configure, InstallerConfig,   # единая конфигурация (прокси на skillkit + dist-имя)
+    make_self_update_command,     # фабрика clikit-команды `self-update` (PyPI)
+    render_install_script,        # генератор ASCII bootstrap-скриптов (sh/ps1)
+    ensure_uv, run_doctor,        # окружение продукта: uv + scripts/self_check.py
+    install_direct,               # прямая установка навыка (линковка + bootstrap)
+    publish_to_store,             # публикация в skillery-store (с секрет-гейтом)
+    run_publish_gate,             # секрет-скан + денилист (gitleaks + s-skillgate)
+    build_publish_payload,        # payload POST /skills по манифесту навыка
+)
+```
+
+Кит ставит и CLI `installer`:
+
+```bash
+installer install <путь-к-навыку> [--scope global|project] [--all-agents]
+installer ensure-uv
+installer doctor <каталог-продукта> [--no-self-check]
+installer publish <путь-к-навыку> --tag v1.2.3 [--dry-run] [--force]
+```
+
+- **`configure(InstallerConfig(app_name, dist_name, ...))`** — идемпотентно
+  проецирует брендинг/каталоги на `skillkit.configure` и запоминает `dist_name`
+  для self-update. Каталоги — ленивыми провайдерами (кит env сам не читает).
+- **`make_self_update_command(dist_name)`** → clikit-команда: сверяет версию с
+  PyPI JSON API (`pypi.org/pypi/<dist>/json`), обновляет авто-детектом менеджера
+  (`uv tool` / `pipx` / `pip`), `--check` — только показать. На Windows апгрейд —
+  detached-процессом (launcher `.exe` залочен), применяется со след. запуска.
+  Регистрация: `app.command(name="self-update")(make_self_update_command("s-myctl"))`.
+- **`render_install_script("sh"|"ps1", dist_name, cli_name)`** → строка
+  ASCII-only bootstrap-скрипта (ставит `uv` при отсутствии → `uv tool install
+  --upgrade <dist>`). ASCII гарантируется (иначе `curl|sh` / `irm|iex` ломаются).
+- **`install_direct(path, scope=..., all_agents=...)`** — прямой путь установки
+  (без хаба): материализует навык в центральный стор и линкует
+  junction/symlink'ом в `~/.claude/skills/<slug>` (или в project-scope), гоняет
+  `skillkit.bootstrap_skill` (ensure_uv → deps → бинари → self_check), для
+  `kind = "tooling"` регистрирует MCP-серверы у агента. Возвращает
+  graceful-отчёт `{ok, slug, agents, bootstrap, mcp, errors}` и НЕ бросает;
+  битая ссылка в scope детектится (`link_status = "broken"`).
+- **`ensure_uv()`** — идемпотентно найти/поставить `uv`:
+  `{"uv": <путь|None>, "status": "found" | "installed" | "missing"}`. `found` —
+  uv уже был и ничего не делалось.
+- **`run_doctor(product_dir)`** — сводная проверка окружения продукта: uv, `.venv`,
+  наличие и прогон `scripts/self_check.py`. Возвращает
+  `{ok, uv, venv, self_check_script, self_check, problems}`, не бросает;
+  `installer doctor` печатает отчёт и выходит с кодом 1, если `ok=False`.
+- **`publish_to_store(path, tag=..., client=...)`** — публикация навыка:
+  сначала ГЕЙТ (`run_publish_gate`: gitleaks, если бинарь есть в PATH, плюс
+  `s-skillgate` — regex-секреты и денилист внутренней инфы), затем сборка
+  манифеста (`kind`/`cli`/`mcp`/`runtime_dependencies` — без них хаб не
+  поставит сам инструмент), затем отправка через `client.publish_skill(payload)`
+  (sync и async-клиенты оба). Блокирующие находки → `CliError`
+  (`publish_gate_failed`, exit 1) ДО сборки и сети; `force=True` — сознательный
+  обход. `dry_run=True` возвращает payload, не отправляя (секретные поля в нём
+  замаскированы). Транспорта кит не несёт — клиент инъектирует потребитель;
+  команда `installer publish` без клиента умеет `--dry-run`.
+- Команда `installer publish` закрыта правом **`skill.publish`**: если задан
+  env `INSTALLER_PERMISSIONS`, она регистрируется только при наличии права.
+
+## Контракт `scripts/self_check.py` (самопроверка продукта)
+
+Финальный gate установки: его гоняет и `skillkit.bootstrap_skill`, и
+`installer doctor`. Продукт обязан положить скрипт по пути
+`scripts/self_check.py` в своём корне.
+
+- **Вход**: аргументов нет, stdin не читается (запуск неинтерактивный).
+  Рабочий каталог — корень продукта; интерпретатор выбирается в порядке
+  `<продукт>/.venv/bin/python` → `uv run python` → текущий `sys.executable`.
+- **Выход**: человекочитаемый отчёт в stdout/stderr (оба потока попадают в
+  `self_check.output`). Формат свободный; пишите, ЧТО именно не так.
+- **Коды возврата**: `0` — окружение исправно; **любой ненулевой** — нет
+  (различать 1/2/3 инсталлятор не станет, коды нужны только вашим тестам).
+- **Ограничения**: без сети и без секретов в выводе; таймаут 300 с (skillkit
+  убьёт зависший скрипт). Скрипта нет ⇒ это САМО ПО СЕБЕ проблема:
+  подтвердить окружение нечем, `doctor` вернёт `ok=False`.
+
+```python
+# scripts/self_check.py
+import shutil, sys
+
+problems = [] if shutil.which("uv") else ["нет uv в PATH"]
+print("
+".join(problems) or "окружение исправно")
+sys.exit(1 if problems else 0)
+```
+
+## Разработка
+
+```bash
+uv sync --extra dev
+uv run --extra dev pytest -q
+uv run --extra dev ruff check installerkit tests
+```
+
+## Статус
+
+- **Type**: `kit`
+- **Status**: `experiment`
+- **Priority**: P1
+- **Slug**: `s-installerkit`
+- **Prefix**: `si`
+- **Tags**: —
+- Создан: 2026-07-17
+
+## Atlas
+
+Карточка проекта в Atlas-БД (Atlas):
+
+```sh
+atlas projects get s-installerkit
+```
+
+Физический layout:
+
+- Storage: `_storage/s-installerkit/`
+- Junction: `Products\s-installerkit` → `_storage/s-installerkit`
+
+## TODO (placeholder)
+
+- [ ] Заполнить README реальным контентом проекта.
+- [ ] Подключить GitLab-репозиторий (если ещё нет): `atlas projects git init s-installerkit`.

s_installerkit-0.1.0/docs/adr/0000-template.md

@@ -0,0 +1,20 @@
+# NNNN. Краткий заголовок решения
+
+- **Статус:** proposed | accepted | superseded (→ ADR-NNNN) | deprecated
+- **Дата:** ГГГГ-ММ-ДД
+
+## Контекст
+
+Какую ситуацию/проблему решаем. Что вынуждает принять решение сейчас: ограничения, требования, силы, которые тянут в разные стороны. Достаточно, чтобы понять «почему» без внешнего контекста.
+
+## Решение
+
+Что именно решили — одной-двумя фразами, в настоящем времени: «Делаем X». Конкретно и проверяемо.
+
+## Последствия
+
+Что становится проще и что — сложнее/дороже после принятия. Плюсы, минусы, новые обязательства и ограничения, которые теперь придётся держать.
+
+## Альтернативы
+
+Какие варианты рассматривали и **почему отклонили** (в этом ценность записи). Кратко: вариант → причина отказа / отложено до условия.

s_installerkit-0.1.0/docs/adr/README.md

@@ -0,0 +1,30 @@
+# ADR — журнал архитектурных решений
+
+**Что это.** ADR (Architecture Decision Record) — короткий документ на **одно** архитектурное решение: контекст → что решили → почему → последствия. Лежат здесь, в `docs/adr/`, со **сквозной нумерацией** (`0001-…`, `0002-…`). Шаблон — [`0000-template.md`](0000-template.md).
+
+**Зачем.** «Почему» проекта нельзя держать в комментариях к задачам и переписке — оно теряется. ADR — дистиллят решения: агент читает его **перед** правкой и не «чинит» то, что было выбрано сознательно. Дёшев по токенам: одно решение прочитать проще, чем реконструировать его из истории коммитов.
+
+## Когда заводить ADR — когда сошлись 3 условия
+
+1. решение **дорого откатить** (влияет на структуру, данные, контракты);
+2. без контекста оно **выглядит странно** (кто-то потом захочет «починить»);
+3. были **реальные альтернативы** и выбор — осознанный трейдофф.
+
+Если хотя бы одно условие не выполнено — ADR не нужен, хватит `comment` на задаче в Atlas.
+
+## Правила ведения
+
+- **Нумерация сквозная**, файл — `NNNN-краткий-слаг.md` (`0001-operating-model-foundamentals.md`).
+- **Не редактировать задним числом.** Принятое решение — исторический факт. Если решение отменено новым — старому ставим `Статус: superseded` (со ссылкой на новое ADR), а не переписываем его.
+- **«Схлопывание».** Когда цепочка `superseded` разрослась, допустимо свести её к одному ADR с текущим состоянием — ради экономии контекста агента. Прежние помечаем как схлопнутые.
+- **Статусы:** `proposed` → `accepted` → (`superseded` / `deprecated`).
+
+## Что НЕ идёт в ADR
+
+- **состояние** (ветка/worktree, стадия) — это тег/поле задачи в Atlas;
+- **ход работы / handoff** — `comment` на задаче в Atlas;
+- **черновой план реализации** — scratchpad, в `.gitignore`, в репо не коммитится.
+
+Полная модель фиксации артефактов (4 слоя) — в `ai-ecosystem-core/AGENT-OPERATING-MODEL.md`, раздел «Модель фиксации артефактов».
+
+**Методология:** практика ADR (Michael Nygard), компактный формат Matt Pocock (`github.com/mattpocock/skills`, grill-with-docs), примеры в NATS / AG2.

s_installerkit-0.1.0/installerkit/__init__.py

@@ -0,0 +1,61 @@
+"""installerkit — тонкий слой установки/самообновления CLI-продуктов над skillkit.
+
+Кит НЕ дублирует механику skillkit (``ensure_uv`` / ``bootstrap_skill`` /
+manifest / линковка навыка) — он её ПЕРЕИСПОЛЬЗУЕТ и добавляет верхний слой:
+
+- ``configure`` / ``InstallerConfig`` — единая конфигурация установщика
+  (проксирует ``skillkit.configure`` + хранит dist-имя для self-update);
+- ``make_self_update_command`` — фабрика clikit-команды ``self-update`` (сверка
+  версии с PyPI + авто-детект менеджера uv tool/pipx/pip);
+- ``render_install_script`` — генератор ASCII bootstrap install-скриптов
+  (curl|sh / irm|iex, ставит uv → ``uv tool install <dist>``);
+- ``ensure_uv`` / ``run_doctor`` — окружение продукта: идемпотентный uv и прогон
+  ``scripts/self_check.py`` со сводным отчётом;
+- ``install_direct`` — прямой путь установки: линковка навыка в scope агента
+  (junction/symlink) + ``skillkit.bootstrap_skill`` + регистрация MCP;
+- ``publish_to_store`` / ``run_publish_gate`` / ``build_publish_payload`` — путь
+  через skillery: секрет+денилист-гейт (gitleaks + s-skillgate) ПЕРЕД сборкой,
+  манифест публикации и отправка инъектируемым клиентом.
+
+Dist-имя для импорта — ``installerkit``; имя дистрибутива — ``s-installerkit``.
+"""
+from __future__ import annotations
+
+from installerkit.config import InstallerConfig, configure
+from installerkit.direct import install_direct
+from installerkit.doctor import ensure_uv, run_doctor
+from installerkit.install_scripts import render_install_script
+from installerkit.publish import (
+    PUBLISH_PERMISSION,
+    GateFinding,
+    GateResult,
+    build_publish_payload,
+    publish_to_store,
+    run_publish_gate,
+)
+from installerkit.self_update import make_self_update_command
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "__version__",
+    # конфигурация установщика (прокси на skillkit + dist-имя)
+    "configure",
+    "InstallerConfig",
+    # self-update (PyPI + авто-детект менеджера)
+    "make_self_update_command",
+    # генератор install-скриптов (ASCII bootstrap)
+    "render_install_script",
+    # окружение продукта (uv + self_check)
+    "ensure_uv",
+    "run_doctor",
+    # прямой путь установки (линковка + bootstrap + MCP)
+    "install_direct",
+    # публикация в skillery-store (гейт -> манифест -> отправка)
+    "publish_to_store",
+    "run_publish_gate",
+    "build_publish_payload",
+    "GateResult",
+    "GateFinding",
+    "PUBLISH_PERMISSION",
+]

s_installerkit-0.1.0/installerkit/_branding.py

@@ -0,0 +1,30 @@
+"""Брендо-строки s-installerkit в одном месте (namespace S-kits + дефолты).
+
+Кит брендо-нейтрален: потребитель переопределяет ``app_name`` через
+:class:`~installerkit.config.InstallerConfig`. Здесь — лишь дефолты и публичные
+константы (git-namespace открытой группы S-kits, URL официальных инсталлеров
+менеджера пакетов ``uv``). Ни одного секрета — только публичные адреса.
+"""
+from __future__ import annotations
+
+#: platformdirs app-name по умолчанию (само-имя кита; переопределяется потребителем
+#: через ``InstallerConfig.app_name`` → ``skillkit.configure``).
+DEFAULT_APP_NAME = "installerkit"
+
+#: Открытая группа S-kits на GitLab — namespace git-репозиториев китов.
+#: Имя репозитория БЕЗ префикса ``s-`` (skillkit/clikit/librarykit); dist-имя — С ним.
+SKITS_GITLAB_NAMESPACE = "https://gitlab.com/S-kits"
+
+#: Официальные инсталлеры менеджера пакетов ``uv`` (Astral) — публичные скрипты.
+#: В install-скриптах используются как источник bootstrap uv при его отсутствии.
+UV_INSTALL_SH = "https://astral.sh/uv/install.sh"
+UV_INSTALL_PS1 = "https://astral.sh/uv/install.ps1"
+
+
+def skit_git_url(repo: str) -> str:
+    """git-URL кита в группе S-kits (``repo`` — имя без префикса ``s-``).
+
+    Ветку задаёт потребитель в ``[tool.uv.sources]`` своего pyproject; здесь —
+    лишь базовый URL репозитория.
+    """
+    return f"{SKITS_GITLAB_NAMESPACE}/{repo}.git"