s-skillkit 0.4.0__tar.gz → 0.5.0__tar.gz

s_skillkit-0.5.0/.gitlab-ci.yml

@@ -0,0 +1,101 @@
+# СГЕНЕРИРОВАНО из devcontour/tools/kits/template/gitlab-ci.yml — не правь здесь.
+# Правка идёт в шаблон, затем `python tools/kits/apply_template.py <кит>`.
+# Сверка: `python tools/kits/apply_template.py <кит> --check` (код 1 при расхождении).
+#
+# Автопубликация на PyPI по семвер-тегу vX.Y.Z через Trusted Publishing (OIDC).
+# Три стадии, и это не украшение: версии на PyPI неизменяемы, и шесть китов
+# уезжали туда без единого теста (browserkit 0.0.18, netkit ≤0.0.12 — оба в бою).
+#   gates          — тесты, линтер, слои, doctor: на каждый push и на тег
+#   release-guard  — тег == версия во всех местах (pyproject/uv.lock/CHANGELOG)
+#   publish-pypi   — только после двух первых; версия, уже лежащая на PyPI, не
+#                    публикуется повторно (тег «догоняет» выпуск, а не роняет CI);
+#                    после сборки и до обмена токена — check_dist_leaks.py
+#                    (личные данные разработчика в собранном дистрибутиве)
+# Токены НИГДЕ не хранятся: GitLab выдаёт короткоживущий OIDC-токен (PYPI_ID_TOKEN),
+# он одноразово обменивается на PyPI API-токен. Издатель настраивается на pypi.org:
+#   Manage -> Publishing -> GitLab  (namespace=S-kits, project=skillkit,
+#   top-level pipeline file=.gitlab-ci.yml, environment — пусто).
+# Дистрибутив на PyPI: s-skillkit.
+stages: [test, guard, publish]
+
+.uv:
+  image: ghcr.io/astral-sh/uv:python3.12-bookworm
+
+gates:
+  extends: .uv
+  stage: test
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+    - if: $CI_PIPELINE_SOURCE == "push"
+  script:
+    # dev-зависимости у китов объявлены двумя способами — extra `dev` и группа
+    # `[dependency-groups] dev`; --all-extras покрывает первое, группу добавляем
+    # только если она объявлена, иначе uv падает «Group dev is not defined».
+    - uv sync --all-extras $(python3 -c "import tomllib;print('--group dev' if 'dev' in tomllib.load(open('pyproject.toml','rb')).get('dependency-groups',{}) else '')")
+    - uv run pytest tests/ -q
+    # Линтер по ВСЕМУ пакету, а не по списку файлов: сужение до «файлов волны 0»
+    # держалось девять китов и ни разу не было расширено — сужение приживается,
+    # расширение нет.
+    - uv run ruff check .
+    # Границы слоёв: контракт в .importlinter (ставится тем же шаблоном).
+    #  — доп. пакеты через --with (пусто у большинства
+    # китов; adapterkit — пример кита, которому нужен сосед на прогоне
+    # lint-imports, см. apply_template.py --extra-with).
+    - uv run --with import-linter lint-imports
+    # Гейт 1, часть «согласованность локальных venv» (kitsctl doctor). Скрипт
+    # раздаётся шаблоном не всем: в раннере видно ОДИН репозиторий, соседних
+    # venv'ов там нет, — поэтому шаг условный и молча пропускается, когда
+    # инструмента у кита нет. Настоящее место doctor — локальный прогон перед
+    # тегом; см. docs/kits/SAFETY-NET.md, «Известные ограничения».
+    - 'if [ -f scripts/kitsctl.py ]; then python3 scripts/kitsctl.py doctor; else echo "kitsctl doctor — инструмента нет в репозитории, пропуск (см. SAFETY-NET.md)"; fi'
+
+release-guard:
+  extends: .uv
+  stage: guard
+  needs: [gates]
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+  script:
+    - python3 scripts/release_guard.py "$CI_COMMIT_TAG"
+
+publish-pypi:
+  extends: .uv
+  stage: publish
+  needs: [release-guard]
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+  id_tokens:
+    PYPI_ID_TOKEN:
+      aud: pypi
+  script:
+    - |
+      DIST=$(python3 -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['name'])")
+      VER="${CI_COMMIT_TAG#v}"
+      if python3 - "$DIST" "$VER" <<'PY'
+      import json, sys, urllib.request
+      dist, ver = sys.argv[1], sys.argv[2]
+      try:
+          data = json.load(urllib.request.urlopen(f"https://pypi.org/pypi/{dist}/json"))
+      except Exception:
+          sys.exit(1)
+      sys.exit(0 if ver in data.get("releases", {}) else 1)
+      PY
+      then echo "версия $VER уже на PyPI — публикацию пропускаем"; exit 0; fi
+    - uv build
+    # Последний рубеж перед необратимым шагом (версии на PyPI неизменяемы,
+    # yank — не удаление). Прецедент — leasekit: реальный email и домашний
+    # путь разработчика уехали в публичный индекс из тестовых фикстур. Ловит
+    # по классам, не по строкам; см. docs/kits/SAFETY-NET.md.
+    - python3 scripts/check_dist_leaks.py dist/
+    - |
+      export UV_PUBLISH_TOKEN=$(python3 - <<'PY'
+      import json, os, urllib.request
+      req = urllib.request.Request(
+          "https://pypi.org/_/oidc/mint-token",
+          data=json.dumps({"token": os.environ["PYPI_ID_TOKEN"]}).encode(),
+          headers={"Content-Type": "application/json"},
+      )
+      print(json.load(urllib.request.urlopen(req))["token"])
+      PY
+      )
+    - uv publish

s_skillkit-0.5.0/.importlinter

@@ -0,0 +1,66 @@
+# СГЕНЕРИРОВАНО из devcontour/tools/kits/template/importlinter.ini — не правь
+# здесь. Правка идёт в шаблон, затем `python tools/kits/apply_template.py <кит>`.
+#
+# Заготовка контракта слоёв. Запуск: `uv run --with import-linter lint-imports`.
+#
+# Контракт ниже — минимум, который годится ЛЮБОМУ киту и не требует ручной
+# настройки: «skillkit не импортирует те киты экосистемы, которых нет в его
+# объявленных зависимостях». Скрытая зависимость — это кит, который работает у
+# автора (сосед стоит в venv) и разваливается у потребителя на первом импорте;
+# именно так ломались pypi-publish и gemini-chat.
+#
+# Список forbidden_modules подставлен установщиком из реестра китов на момент
+# установки: все известные пакеты китов МИНУС собственный МИНУС объявленные в
+# pyproject зависимости. Появилась новая честная зависимость — объяви её в
+# pyproject и переустанови шаблон, а не правь этот файл.
+#
+# Собственные контракты кита (layers/eager_forbidden/declared_dependencies,
+# как у adapterkit) дописываются НИЖЕ отдельными секциями прямо в этом файле.
+# Установщик сверяет файл целиком, поэтому `--check` после такой правки
+# закономерно покажет расхождение с каноном — это ожидаемо и осознанно
+# игнорируется в отчёте ревью, см. docs/kits/SAFETY-NET.md, «Что делать при
+# расхождении» (п.2).
+
+[importlinter]
+# include_external_packages нужен: forbidden_modules перечисляет пакеты,
+# внешние относительно root_packages.
+include_external_packages = True
+root_packages =
+    skillkit
+exclude_type_checking_imports = True
+
+[importlinter:contract:no-undeclared-kits]
+name = skillkit не импортирует киты, которых нет в его зависимостях
+type = forbidden
+source_modules =
+    skillkit
+forbidden_modules =
+    accountpoolkit
+    adapterkit
+    agentskit
+    aichatkit
+    authkit_client
+    authkit_contracts
+    authkit_server
+    b24kit
+    browserkit
+    chatkit
+    clientkit
+    corekit
+    emojikit
+    gitkit
+    installerkit
+    iokit
+    issuekit
+    leasekit
+    maxkit
+    modelkit
+    netkit
+    ormkit
+    persistkit
+    servicekit
+    sessionkit
+    socialkit
+    storagekit
+    totp_client
+    worker_service

s_skillkit-0.5.0/.skillgateignore

@@ -0,0 +1,12 @@
+# Исключения для секрет-скана s-skillgate перед push. Глобы — от корня репо.
+#
+# scripts/check_dist_leaks.py — сам гейт утечки личных данных (сетка
+# безопасности китов, docs/kits/SAFETY-NET.md в devcontour), копия из
+# tools/kits/template/check_dist_leaks.py. Ловит по классам, не по строкам:
+# windows-путь с числовым именем пользователя, личный ящик на публичном
+# провайдере, юникс-домашний путь. Regex-паттерны и пример подсказки
+# (windows-путь с числовым account, «/home/user») по определению совпадают
+# с собственным денилистом — иначе гейт не проверял бы то, ради чего написан (та же
+# ситуация, что и с tests/golden/ у самого check_dist_leaks.py). Файл
+# копируется буквально из канона — правки идут в шаблон, не сюда.
+scripts/check_dist_leaks.py

{s_skillkit-0.4.0 → s_skillkit-0.5.0}/CHANGELOG.md

@@ -4,7 +4,38 @@
 [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/); версионирование —
 [SemVer](https://semver.org/lang/ru/).
 
-## [Unreleased]
+## [0.5.0] — 2026-09-08
+
+### Добавлено
+
+- **`skillkit.installer_cli`** — установщик навыков переехал сюда из псевдокита
+  `s-installerkit` (волна 5, Atlas #2710). Зависимость объявлена ОПЦИОНАЛЬНЫМ
+  extra `installer_cli`: он тянет сеть, ключи и хранилище паролей, а базовый
+  `pip install s-skillkit` должен оставаться без них.
+- Два сырых вызова подпроцесса в перенесённом коде переведены на `skillkit.proc.run`,
+  отсоединённый запуск самообновления вынесен в отдельный разрешённый модуль.
+
+## [0.4.1] — 2026-09-01
+
+### Fixed — `IAgentTarget` снова экспортируется из `skillkit.targets` (#2542)
+
+Выпуск 0.4.0 уронил `skillery login` у пользователя с чистой установкой:
+
+```
+from skillkit.targets import (
+ImportError: cannot import name 'IAgentTarget' from 'skillkit.targets'
+```
+
+Протокол переименовали `IAgentTarget` → `AgentTarget` (lib#667) и положили
+совместимое имя в `skillkit/targets/base.py`. Этого оказалось мало: чужой код
+зовёт имя **из пакета**, а не из модуля `base`. Теперь алиас реэкспортируется
+пакетом и объявлен в его `__all__`.
+
+Почему не поймали заранее: у разработчика в окружении стоял кит 0.3.7 (там ещё
+старое имя и нет нового), а `s-skillkit` тянется с верхней границей открытой —
+пользователь получил 0.4.0 и упал. Сторож `tests/test_targets_public_names.py`
+теперь проверяет ровно тот импорт, на котором падал клиент.
+
 
 ### Added — канон навыка переехал в кит: `skillkit.canon` (#162)
 
@@ -56,6 +87,27 @@
   положил бы этот же навык сейчас. Повторная установка ТОГО ЖЕ навыка (в т.ч. с
   новым entrypoint/config) проходит как раньше.
 
+## [0.4.0] — 2026-09-01
+
+Выпуск без отдельной записи в журнале на момент публикации. Изменения между `v0.3.7` и `v0.4.0` — по истории коммитов:
+
+- IAgentTarget → AgentTarget: контракт без венгерского префикса (lib#667) (ce15ab5)
+- changelog навыка можно держать файлом, а не строкой в TOML (f31a516)
+- skillkit: богатые поля frontmatter Claude доезжают до манифеста (#2430) (54b5c74)
+- skillkit: плагин как единица поставки — манифест плюс реестр (#2431) (6298cdf)
+- docs/adr: журнал архитектурных решений заведён (#807) (951b39f)
+- Канон навыка переехал в кит: один источник вместо трёх (#162) (39d73ae)
+
+## [0.3.7] — 2026-08-25
+
+Выпуск без отдельной записи в журнале на момент публикации. Изменения между `v0.3.6` и `v0.3.7` — по истории коммитов:
+
+- fix(владение): CLI-команда и MCP-сервер не перехватываются чужим навыком (#2272) (6480860)
+- test(владение): три случая перехвата артефактов + идемпотентность (#2272) (faf534b)
+- docs(владение): CHANGELOG + докстринги модулей про гейт принадлежности (#2272) (5dc6183)
+- merge(#2272): артефакт навыка не перехватывается чужим — команда и MCP-сервер под владением (d6cefbf)
+- chore(release): s-skillkit 0.3.7 — владение артефактами навыка (6dcf7de)
+
 ## [0.3.6]
 
 ### Changed — своя политика запуска подпроцессов, s-librarykit убран (#1644)
@@ -157,6 +209,34 @@
   `install_from_path` не изменилась. Миграция уже установленных сторов — на
   стороне CLI (признак: `source == "local-path"` при непустом `skill_id`).
 
+## [0.3.4] — 2026-07-28
+
+Выпуск без отдельной записи в журнале на момент публикации. Изменения между `v0.3.3` и `v0.3.4` — по истории коммитов:
+
+- feat(telemetry): адаптер Skillery поверх нейтрального telemetrykit (0.3.4) (ea7390e)
+
+## [0.3.3] — 2026-07-27
+
+Выпуск без отдельной записи в журнале на момент публикации. Изменения между `v0.3.2` и `v0.3.3` — по истории коммитов:
+
+- feat: единый запуск процессов, .pkgsrc не течёт в зону агента, снапшот = hub (#1144 #1145 #1147) (1e5ac4a)
+
+## [0.3.2] — 2026-07-22
+
+Выпуск без отдельной записи в журнале на момент публикации. Изменения между `v0.2.1` и `v0.3.2` — по истории коммитов:
+
+- @ fix: монорепо-навык (skill_path) + preserved_paths из манифеста + детект менеджера (b8a9bda)
+- fix(antigravity): цель писала в путь, который агент не читает (067c840)
+- feat(hooks): навык объявляет хук в манифесте; путь .antigravity убран совсем (4d093a2)
+- fix(targets)!: раскладки навыков по доказанной таблице (agy/opencode/codex) (1b6ec80)
+- fix(remove)!: кит удаляет только своё + миграция старого канона Codex + лок (9cb7d60)
+- fix(ownership)!: гейт принадлежности — свойство ОПЕРАЦИИ + сирота .antigravity (круг 3) (1a14015)
+- fix(ownership): маркер принадлежности в мете + детектор устойчив к алиасам (круг 4) (678bd85)
+- fix(ownership): улика принадлежности строго по маркеру + детектор ловит свои модули (880aa18)
+- fix(ownership): migrate штампует маркер владения для legacy-каталогов (круг 5) (58ceb0a)
+- fix(fetcher): git clone без видимого окна на Windows (CREATE_NO_WINDOW) (#1028) (ab4eaf5)
+- feat(targets): единый источник путей агентов + antigravity=.agents/skills; CI PyPI (b6ff6a8)
+
 ## [0.3.1] — 2026-07-21
 
 Круг 3 независимой проверки нашёл два настоящих дефекта в правках 0.3.0 и один
@@ -439,6 +519,27 @@ opencode её НЕ видит) доказывает, что модель не п
   установки под ТЕКУЩУЮ ОС и список реально доступных альтернатив. ИИ-агент
   может довести установку сам.
 
+## [0.2.1] — 2026-07-20
+
+Выпуск без отдельной записи в журнале на момент публикации. Изменения до тега `v0.2.1` — по истории коммитов:
+
+- feat: skillkit v0.1.0 — локальное ядро управления навыками (вырезано из Skillery CLI, cli-kits W7); sibling librarykit, 0 внешних завязок (4aa8ee2)
+- feat: гибрид-модули (path_store/tooling/deps_installer/mcp_register/collections) из Skillery CLI — добивка W7; инъекция bin/config-провайдеров (c77c495)
+- fix(deps): pip-установка с --upgrade — зависимости поднимаются при апдейте (gap B) (5d76a64)
+- fix(installer): пустой files-инвентарь не затирает стор при update (#272 BUG-3) (e7bcb7e)
+- chore(release): s-skillkit 0.1.2 (фикс BUG-3 #272 — пустой files-инвентарь не затирает стор) (230ab79)
+- feat(installer): subdir-навык — материализация подпапки репо (#268) (4a479f3)
+- chore(release): s-skillkit 0.1.3 (#268 subdir-навык: материализация подпапки репо) (e80b7c9)
+- fix(manifest): build_manifest несёт kind/cli/mcp/runtime_dependencies (#271) (8f88a86)
+- test(manifest): регресс на tooling-поля + TOML-порядок runtime_dependencies (#271) (582fdaa)
+- fix(tooling): runtime_deps-CLI в выделенный venv + шим целит туда же (#271) (df9f16e)
+- feat(config): SkillkitConfig + configure() — единая брендо-конфигурация (0.2.0) (b4366b0)
+- chore(release): s-skillkit 0.1.5 — версия в патч-серии 0.1.x (не 0.2.0) (c15beb2)
+- feat(installer): install_from_snapshot — установка навыка из tar.gz-слепка (4f8c748)
+- feat(installer): транзакционный install (#437) + release 0.1.7 (e236c94)
+- fix(manifest): folded YAML scalar (>) в _read_frontmatter + bump 0.1.8 (c5d26c1)
+- …и ещё 14 коммит(ов), см. `git log v0.2.1`
+
 ## [0.2.0] — 2026-07-15
 
 ### Added — install-kit (установка навыка «под ключ» со ВСЕМИ зависимостями)

{s_skillkit-0.4.0 → s_skillkit-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: s-skillkit
-Version: 0.4.0
+Version: 0.5.0
 Summary: Локальное ядро управления навыками: install из git/локальной папки, junction/symlink-линковка в scope агента, .skillignore-фильтр, build manifest, project-манифест. 0 завязок на сеть/auth — stdlib + tomli-w + pathspec + platformdirs.
 Author: Dmitry
 License: MIT
@@ -10,9 +10,9 @@ Requires-Dist: pathspec>=0.12.0
 Requires-Dist: platformdirs>=4.0
 Requires-Dist: s-telemetrykit>=0.2.0
 Requires-Dist: tomli-w>=1.0
-Provides-Extra: dev
-Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
-Requires-Dist: pytest>=8; extra == 'dev'
+Provides-Extra: installer-cli
+Requires-Dist: s-clikit>=0.1.6; extra == 'installer-cli'
+Requires-Dist: s-librarykit<0.9; extra == 'installer-cli'
 Description-Content-Type: text/markdown
 
 # s-skillkit

{s_skillkit-0.4.0 → s_skillkit-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "s-skillkit"
-version = "0.4.0"
+version = "0.5.0"
 description = "Локальное ядро управления навыками: install из git/локальной папки, junction/symlink-линковка в scope агента, .skillignore-фильтр, build manifest, project-манифест. 0 завязок на сеть/auth — stdlib + tomli-w + pathspec + platformdirs."
 readme = "README.md"
 license = { text = "MIT" }
@@ -31,8 +31,30 @@ dependencies = [
     "s-telemetrykit>=0.2.0",
 ]
 
+#: installer_cli (волна 5, #2710) — бывший псевдокит installerkit, консолидирован
+#: как ``skillkit.installer_cli``. Тянет s-clikit (а с ним — httpx/keyring) и
+#: s-librarykit (токен-стор installer_cli.tokens — ``librarykit.SecretStore``):
+#: РОВНО тот сетевой/крипто-стек, который #1644 убрал из корня кита. Поэтому
+#: extra, а НЕ dependencies: базовый `pip install s-skillkit` остаётся без
+#: сети/auth; сетевой self-update/publish/токен-слой ставится явно —
+#: `pip install s-skillkit[installer_cli]`. Модуль и не импортируется eagerly
+#: из ``skillkit/__init__.py`` (тот же приём, что у ``skillkit.telemetry``).
 [project.optional-dependencies]
-dev = ["pytest>=8", "pytest-asyncio>=0.24"]
+installer_cli = ["s-clikit>=0.1.6", "s-librarykit<0.9"]
+
+#: Инструменты прогона объявлены ГРУППОЙ, а не extra, намеренно (skl#2545).
+#: extra ставится только по явному `--extra dev`; забыли флаг — pytest в
+#: окружении нет, и `uv run pytest` молча берёт СИСТЕМНЫЙ, вместе с системными
+#: версиями зависимостей. 01.09.2026 так и вышло: прогон шёл на Python 3.13 с
+#: китом 0.3.6 вместо 3.14 и 0.4.1, то есть проверял не то, что собирается.
+#: Группу `dev` uv синхронизирует сама, без флагов.
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.24",
+    "ruff>=0.6",
+    "typing-extensions>=4.6",
+]
 
 [build-system]
 requires = ["hatchling"]
@@ -63,6 +85,10 @@ ignore = ["RUF001", "RUF002", "RUF003", "RUF022", "RUF059"]
 # модуля целиком, потому что `# noqa` внутри многострочного литерала уехал бы в
 # сам вывод.
 "skillkit/canon.py" = ["E501"]
+# install_scripts.py (волна 5, #2710, бывший installerkit) — шаблоны bootstrap-
+# скриптов содержат длинные shell/PowerShell one-liner'ы (напр. `irm ... | iex`),
+# которые ДОЛЖНЫ оставаться одной строкой.
+"skillkit/installer_cli/install_scripts.py" = ["E501"]
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"

s_skillkit-0.5.0/scripts/check_dist_leaks.py

@@ -0,0 +1,180 @@
+"""Гейт публикации: артефакты не должны нести личные данные разработчика.
+
+СГЕНЕРИРОВАНО из devcontour/tools/kits/template/check_dist_leaks.py — не правь
+в ките. Правка идёт в шаблон, затем `python tools/kits/apply_template.py <кит>`.
+Канонизирован из `leasekit/scripts/check_dist_leaks.py` (там появился первым,
+как единственная у кита реальная защита публикации) — ревью волны 0 нашло,
+что канон для всех китов её потерял, хотя случай, из-за которого она
+написана, не специфичен для одного кита.
+
+Зачем. Это уже случилось по-настоящему: в публичный PyPI уехали версии кита с
+реальным email и домашним путём разработчика — они попали туда из ТЕСТОВЫХ
+фикстур, которые никто не считал «настоящими данными». Удалить релиз с PyPI
+нельзя (только yank, а окно удаления — 72 часа по PEP 763), поэтому цена
+ошибки несимметрична: проверка стоит секунду, утечка необратима.
+
+Ручная проверка перед каждым релизом не работает — её забывают ровно тогда,
+когда релиз срочный. Поэтому она здесь, в CI, ДО шага публикации.
+
+Что ловим (по классам, а не по конкретным строкам — иначе гейт защищает от
+одного известного случая и слеп ко всем остальным):
+
+1. **Windows-путь с числовым именем пользователя** — ``C:/Users/<цифры>/…``.
+   Числовое имя — почти всегда реальный аккаунт (у выдуманных пишут ``user``).
+2. **Ящик на публичном почтовом провайдере** (gmail, yandex, mail.ru, …) —
+   именно так выглядела реальная утечка. Синтетику вроде ``x@y.io`` и ssh-URL
+   ``git@github.com`` намеренно НЕ трогаем: гейт, который шумит на каждом
+   тестовом адресе, перестают читать, и он теряет смысл.
+3. **Юникс-домашний путь** ``/home/<name>`` и ``/Users/<name>`` c именем,
+   не похожим на плейсхолдер.
+
+Запуск::
+
+    python scripts/check_dist_leaks.py dist/
+
+Код возврата 1 = найдено, публикацию продолжать нельзя.
+"""
+from __future__ import annotations
+
+import re
+import sys
+import tarfile
+import zipfile
+from pathlib import Path
+
+#: Публичные почтовые провайдеры. Ловим ТОЛЬКО их, а не «любой email»: в тестах
+#: полно синтетических адресов (``x@y.io``, ``o@e.com``) и ssh-URL
+#: (``git@github.com``) — гейт, орущий на них, быстро научатся игнорировать, и
+#: он перестанет ловить настоящее. Реальная утечка выглядела ровно так:
+#: живой ящик на gmail в тестовой фикстуре.
+_MAIL_PROVIDERS = (
+    "gmail.com", "googlemail.com", "yandex.ru", "yandex.com", "ya.ru",
+    "mail.ru", "bk.ru", "inbox.ru", "list.ru", "internet.ru",
+    "outlook.com", "hotmail.com", "live.com", "msn.com",
+    "icloud.com", "me.com", "yahoo.com", "proton.me", "protonmail.com",
+    "rambler.ru", "aol.com", "gmx.com", "zoho.com",
+)
+#: Имена-плейсхолдеры в путях: их наличие означает «фикстура», а не живой аккаунт.
+_SAFE_USER_NAMES = ("user", "testuser", "runner", "someone", "alice", "bob", "ci")
+
+_RULES: tuple[tuple[str, re.Pattern[str]], ...] = (
+    (
+        "windows-путь с числовым именем пользователя",
+        re.compile(r"[Cc]:[\\/]+Users[\\/]+\d{3,}", re.IGNORECASE),
+    ),
+    (
+        "личный ящик на публичном почтовом провайдере",
+        re.compile(
+            r"\b[\w.+-]+@(?:" + "|".join(d.replace(".", r"\.") for d in _MAIL_PROVIDERS) + r")\b",
+            re.IGNORECASE,
+        ),
+    ),
+    (
+        "домашний путь юникс",
+        # ``(?<![:\w])`` отсекает хвост windows-пути: в ``C:/Users/10001`` перед  # leak-gate-allow
+        # ``/Users`` стоит двоеточие, и это дело windows-правила — иначе одна
+        # строка давала бы две жалобы подряд.
+        re.compile(r"(?<![:\w])/(?:home|Users)/([A-Za-z0-9._-]{3,})"),
+    ),
+)
+
+#: Маркер осознанного исключения. Ставится в ТОЙ ЖЕ строке и глушит гейт только
+#: на ней. Нужен там, где «подозрительное» значение — суть теста: например,
+#: фикстура денилист-гейта обязана содержать путь вида ``C:/Users/<цифры>``,
+#: иначе тест не проверяет ровно то, ради чего написан. Пофайловый skip тут не
+#: годится — он бы ослепил гейт на весь файл, включая будущие правки.
+_ALLOW_MARKER = "leak-gate-allow"
+
+#: Файлы, где совпадение — заведомо не утечка (списки исключений, метаданные
+#: автора пакета клиент и так видит на странице PyPI).
+_SKIP_SUFFIXES = (".gitignore", ".dockerignore", "METADATA", "PKG-INFO")
+
+#: Каталоги-эталоны сканеров секретов. В `tests/golden/` у `s-skillgate` лежат
+#: ОБРАЗЦЫ срабатываний правил — файл сверяется дословно, поэтому построчный
+#: `leak-gate-allow` туда не вписать (он ломает сравнение), а без образцов
+#: сканер нечем проверять. Исключение намеренно узкое: только этот подкаталог,
+#: не весь `tests/` — настоящая утечка в прошлый раз пришла именно из обычного
+#: тестового файла.
+_SKIP_PATH_PARTS = ("/tests/golden/",)
+
+
+def _is_benign(rule: str, hit: str) -> bool:
+    low = hit.lower()
+    if rule.startswith("личный ящик"):
+        # ssh-URL вида git@github.com сюда не попадает (github.com не провайдер),
+        # но no-reply-адреса роботов формально живут на публичных доменах.
+        return low.startswith(("noreply@", "no-reply@", "git@"))
+    if rule.startswith("домашний"):
+        return any(n in low for n in _SAFE_USER_NAMES)
+    return False
+
+
+def _iter_members(path: Path):
+    """(имя, текст) по каждому текстовому файлу архива."""
+    if path.name.endswith((".tar.gz", ".tgz")):
+        with tarfile.open(path) as tar:
+            for member in tar.getmembers():
+                if not member.isfile():
+                    continue
+                fh = tar.extractfile(member)
+                if fh is None:
+                    continue
+                yield member.name, fh.read()
+    elif path.suffix == ".whl":
+        with zipfile.ZipFile(path) as zf:
+            for name in zf.namelist():
+                if name.endswith("/"):
+                    continue
+                yield name, zf.read(name)
+
+
+def scan(dist_dir: Path) -> list[str]:
+    problems: list[str] = []
+    archives = [p for p in dist_dir.iterdir() if p.suffix == ".whl" or p.name.endswith(".tar.gz")]
+    if not archives:
+        raise SystemExit(f"в {dist_dir} нет артефактов — нечего проверять")
+    for archive in archives:
+        for name, raw in _iter_members(archive):
+            if name.endswith(_SKIP_SUFFIXES):
+                continue
+            norm = "/" + name.replace("\\", "/").lstrip("/")
+            if any(part in norm for part in _SKIP_PATH_PARTS):
+                continue
+            text = raw.decode("utf-8", "ignore")
+            # Построчно: allow-маркер действует ровно на свою строку, и в отчёт
+            # попадает номер — иначе искать совпадение в файле на 5000 строк.
+            for lineno, line in enumerate(text.splitlines(), 1):
+                if _ALLOW_MARKER in line:
+                    continue
+                for rule, pattern in _RULES:
+                    for match in pattern.finditer(line):
+                        shown = match.group(0)
+                        # Для правила с группой (домашний путь) судим по имени
+                        # пользователя, для остальных — по совпадению целиком.
+                        subject = match.group(1) if match.groups() else shown
+                        if _is_benign(rule, subject):
+                            continue
+                        problems.append(
+                            f"{archive.name} :: {name}:{lineno} :: {rule} :: {shown}"
+                        )
+    return sorted(set(problems))
+
+
+def main() -> int:
+    dist_dir = Path(sys.argv[1] if len(sys.argv) > 1 else "dist")
+    problems = scan(dist_dir)
+    if problems:
+        print("НАЙДЕНЫ личные данные в артефактах — публикация остановлена:\n")
+        for line in problems:
+            print("  •", line)
+        print(
+            "\nЗамените реальные значения на плейсхолдеры "
+            "(user@example.com, C:/Users/10001, /home/user)."  # leak-gate-allow
+        )
+        return 1
+    print(f"артефакты в {dist_dir} чисты: личных данных не найдено")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())