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

{s_skillkit-0.5.0 → s_skillkit-0.6.2}/.gitignore

@@ -48,3 +48,8 @@ NUL
 
 # git worktrees (агентские)
 .worktrees/
+
+# Отметка локального прогона гейта 3 — свидетельство «на ЭТОЙ машине
+# потребители были зелёные». В git ей не место: там она означала бы, что
+# прогон был у всех, а он локальный по построению (раннер не видит соседей).
+.kits-gate3.json

s_skillkit-0.6.2/.gitlab-ci.yml

@@ -0,0 +1,138 @@
+# СГЕНЕРИРОВАНО из 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».
+    # `--locked`: замок обязан соответствовать манифесту, а не тихо
+    # пересобираться под него. Без флага правка пина без `uv lock` доезжает до
+    # прода незамеченной — CI зелёный, а у потребителя приезжает старая версия.
+    - uv sync --locked --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'
+    # Гейт 2: у каждой зависимости на кит есть верхняя граница. Значение границы
+    # здесь не вычисляется — в раннере соседних репозиториев нет, версий взять
+    # неоткуда; проверяется НАЛИЧИЕ. Без этого шага правило остаётся устной
+    # дисциплиной, которую забывают: портфель дожил до 248 незакрытых пинов
+    # ровно потому, что напоминать о нём было некому (#2800).
+    - 'if [ -f scripts/pins_gate.py ]; then python3 scripts/pins_gate.py --self-check --root .; else echo "гейт пинов — инструмента нет в репозитории, пропуск"; fi'
+    # Гейт колец: объявленное в `[tool.kit] lazy_deps` и правда грузится лениво.
+    # Колец здесь не увидеть (соседей в раннере нет), но видно главное: подъём
+    # такого импорта на верхний уровень замыкает кольцо ПРЯМО СЕЙЧАС, а
+    # выглядит безобидной уборкой («чего он тут в теле функции») — #2833.
+    - 'if [ -f scripts/cycles_gate.py ]; then python3 scripts/cycles_gate.py --self-check --root .; else echo "гейт колец — инструмента нет в репозитории, пропуск"; fi'
+    # Гейт замка: объявленная версия кита ДОЕЗЖАЕТ до окружения. `--locked`
+    # выше ловит другое — что замок не пересобран под манифест; а если у
+    # зависимости переопределён источник (`[tool.uv.sources]` = git/path), то
+    # спецификатор версии в разрешении не участвует вовсе, замок считается
+    # актуальным, и отставание не видит НИКТО. Так agentskit и issuekit
+    # держали clikit 0.1.6 при объявленном >=0.2.1 (#2921).
+    - 'if [ -f scripts/lock_gate.py ]; then python3 scripts/lock_gate.py --self-check --root .; else echo "гейт замка — инструмента нет в репозитории, пропуск"; 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:
+    # КУДА уезжает выпуск, решает признак В САМОМ КИТЕ ([tool.kit] visibility),
+    # а не память человека и не отдельный список где-то в стороне. Приватный кит
+    # (готовый сервис, реализация чужой площадки) уходит в приватный индекс
+    # GitLab по ВСТРОЕННОМУ токену задания — новых секретов заводить не нужно.
+    # Умолчание — private: забыть пометить приватный кит дороже, чем забыть
+    # пометить открытый, и ошибаться надо в безопасную сторону.
+    - |
+      VIS=$(python3 -c "import tomllib;print((tomllib.load(open('pyproject.toml','rb')).get('tool') or {}).get('kit',{}).get('visibility','private'))")
+      echo "видимость кита: $VIS"
+      if [ "$VIS" != "public" ]; then
+        uv build
+        python3 scripts/check_dist_leaks.py dist/
+        uv publish --publish-url "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/pypi"                    --username gitlab-ci-token --password "$CI_JOB_TOKEN"
+        echo "выпуск ушёл в приватный индекс проекта, на публичный PyPI НЕ уезжал"
+        exit 0
+      fi
+    - |
+      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/.gitlab-ci.yml → s_skillkit-0.6.2/.gitlab-ci.yml.bak

@@ -48,6 +48,17 @@ gates:
     # инструмента у кита нет. Настоящее место 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'
+    # Гейт 2: у каждой зависимости на кит есть верхняя граница. Значение границы
+    # здесь не вычисляется — в раннере соседних репозиториев нет, версий взять
+    # неоткуда; проверяется НАЛИЧИЕ. Без этого шага правило остаётся устной
+    # дисциплиной, которую забывают: портфель дожил до 248 незакрытых пинов
+    # ровно потому, что напоминать о нём было некому (#2800).
+    - 'if [ -f scripts/pins_gate.py ]; then python3 scripts/pins_gate.py --self-check --root .; else echo "гейт пинов — инструмента нет в репозитории, пропуск"; fi'
+    # Гейт колец: объявленное в `[tool.kit] lazy_deps` и правда грузится лениво.
+    # Колец здесь не увидеть (соседей в раннере нет), но видно главное: подъём
+    # такого импорта на верхний уровень замыкает кольцо ПРЯМО СЕЙЧАС, а
+    # выглядит безобидной уборкой («чего он тут в теле функции») — #2833.
+    - 'if [ -f scripts/cycles_gate.py ]; then python3 scripts/cycles_gate.py --self-check --root .; else echo "гейт колец — инструмента нет в репозитории, пропуск"; fi'
 
 release-guard:
   extends: .uv
@@ -68,6 +79,22 @@ publish-pypi:
     PYPI_ID_TOKEN:
       aud: pypi
   script:
+    # КУДА уезжает выпуск, решает признак В САМОМ КИТЕ ([tool.kit] visibility),
+    # а не память человека и не отдельный список где-то в стороне. Приватный кит
+    # (готовый сервис, реализация чужой площадки) уходит в приватный индекс
+    # GitLab по ВСТРОЕННОМУ токену задания — новых секретов заводить не нужно.
+    # Умолчание — private: забыть пометить приватный кит дороже, чем забыть
+    # пометить открытый, и ошибаться надо в безопасную сторону.
+    - |
+      VIS=$(python3 -c "import tomllib;print((tomllib.load(open('pyproject.toml','rb')).get('tool') or {}).get('kit',{}).get('visibility','private'))")
+      echo "видимость кита: $VIS"
+      if [ "$VIS" != "public" ]; then
+        uv build
+        python3 scripts/check_dist_leaks.py dist/
+        uv publish --publish-url "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/pypi"                    --username gitlab-ci-token --password "$CI_JOB_TOKEN"
+        echo "выпуск ушёл в приватный индекс проекта, на публичный PyPI НЕ уезжал"
+        exit 0
+      fi
     - |
       DIST=$(python3 -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['name'])")
       VER="${CI_COMMIT_TAG#v}"

s_skillkit-0.6.2/.importlinter

@@ -0,0 +1,70 @@
+# СГЕНЕРИРОВАНО из 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
+    orchestrationkit
+    ormkit
+    persistkit
+    pluginkit
+    replicationkit
+    servicekit
+    sessionkit
+    socialkit
+    storagekit
+    totp_client
+    vaultkit
+    worker_service

s_skillkit-0.5.0/.importlinter → s_skillkit-0.6.2/.importlinter.bak

@@ -56,8 +56,11 @@ forbidden_modules =
     maxkit
     modelkit
     netkit
+    orchestrationkit
     ormkit
     persistkit
+    pluginkit
+    replicationkit
     servicekit
     sessionkit
     socialkit

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

@@ -4,6 +4,59 @@
 [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/); версионирование —
 [SemVer](https://semver.org/lang/ru/).
 
+## [0.6.2] - 2026-10-14
+
+### Fixed
+
+- Verify published payload bytes before hub updates and again before committing staged content; preserve local edits and refuse unknown baselines even with force.
+- Preserve disabled managed MCP entries when updating their commands.
+- Skip filesystem writes for verified current copy projections.
+- Fetch Git releases without inherited newline conversion so Windows and Linux receive the same published bytes.
+
+### Added
+
+- Native DeepSeek Harness skill installation roots with DSH_HOME support.
+- Managed copy projections for agents running under Windows redirection restrictions, with conflict protection and explicit CODEX_HOME support.
+
+## [0.6.1] — 2026-09-09
+
+### Исправлено
+
+- **`ClaudeCodeTarget.mcp_config()` больше не игнорирует подменённый `root`.**
+  Global-путь считался от `Path.home()`, поэтому прогон тестов кита писал
+  «чужой» образец `["важные", "данные", "пользователя"]` в НАСТОЯЩИЙ
+  `~/.claude.json` разработчика. Claude Code читал массив, превращал его в
+  ключи `"0"/"1"/"2"` и дописывал своё — список доверенных проектов пропадал, и
+  диалог «Trust this workspace?» возвращался на уже доверенных папках. На живой
+  машине это случилось дважды за час. Боевое поведение не меняется: по
+  умолчанию `root` = `~/.claude`, его родитель — тот же дом.
+- **Сторож песочницы** (`test_podmenennyi_root_uvodit_vse_puti_v_pesochnitsu`):
+  при подменённом `root` ни один путь цели — ни `base_dir`, ни `slug_dir`, ни
+  дескрипторы MCP и хуков — не ведёт наружу. Проверяются ВСЕ цели разом:
+  соседний `hook_config` правило соблюдал и даже объяснял его в докстринге, так
+  что подвела именно помодульная бдительность.
+
+## [0.6.0] — 2026-09-09
+
+### Удалено (ломающее)
+
+- **`skillkit.plugin_register`** — движок «плагин как единица поставки»
+  (манифест `plugin.json` + запись в реестр агента). Ноль потребителей во всём
+  портфеле, ноль публичной поверхности: нет ни в README, ни в `__all__`, ни в
+  `__init__`, ни в entry-points — причём групп entry-points у кита нет вовсе.
+  Написан 30.08.2026 одним коммитом и больше не трогался. Нишу занял живой
+  `pluginkit` с четырьмя потребителями (gateway, aichatkit, adapterkit, atlas):
+  формально он про python-пакеты, а не про `plugin.json` в каталоге агента, —
+  но второй незанятый движок в той же нише дороже, чем отсутствие обоих.
+- **`PluginDescriptor` и методы `plugin_config`** в `targets/base.py`,
+  `targets/claude_code.py`, `targets/antigravity.py` — хвост, который держался
+  только на удалённом модуле. Убран тем же комплектом: иначе в ките осталась бы
+  раскладка плагинов, которую некому прочитать.
+
+Ломающее для тех, кто аннотировал `PluginDescriptor` или переопределял
+`plugin_config` в своей цели. Таких в портфеле нет (проверено грепом), но
+поверхность целей публична, поэтому минор, а не патч (Atlas #2835).
+
 ## [0.5.0] — 2026-09-08
 
 ### Добавлено

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

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

s_skillkit-0.6.2/docs/agent-projections.md

@@ -0,0 +1,76 @@
+# Readable skill projections
+
+`SkillStore(target, store_dir, projection="auto")` accepts `auto`, `link`, and
+`copy`. An explicit `InstallRequest.projection` overrides the installer default;
+`None` inherits it. The legacy `install`, `install_from_path`,
+`install_from_snapshot`, and `link_existing` keyword APIs accept the same override.
+`materialize` still writes content to the store only.
+
+`auto` preserves the existing link-first behavior for new installations. A skill
+already installed as a managed copy remains a copy on later automatic updates.
+`link` reports link creation failures without silently falling back to a copy.
+`copy` creates a regular skill directory readable by processes that cannot follow
+Windows junctions, including SSH descendants enforcing RedirectionGuard. It does
+not change any Windows security policy.
+
+Each copy has independent metadata under `_skill_meta.json`:
+
+```json
+{
+  "projection": {
+    "kind": "copy",
+    "store_dir": "absolute/source/store/skill",
+    "source_revision": "source-commit",
+    "preserved_paths": ["_local/", "browser_profiles/"],
+    "baseline": {
+      "files": [{"path": "SKILL.md", "sha256": "sha256-of-original-payload"}],
+      "sha256": "sha256-of-canonical-files-index"
+    }
+  }
+}
+```
+
+The baseline comes from a successful fresh materialization or a verified previous
+release manifest. Existing files without a verifiable baseline are never adopted
+as original content. Copy and source payload checks run before source updates;
+the scope is checked again before the transactional swap. Local edits, missing
+files, untracked payload, malformed baselines, runtime links, and unmanaged scope
+entries cause an explicit refusal. `force` does not bypass these checks.
+
+Copy payload excludes `.git`, `.pkgsrc`, `.venv`, bytecode caches, `.env`, and
+declared preserved state. CLI dependencies remain in their independently managed
+runtime. Existing ordinary preserved state in the scope is kept locally; it is
+not copied from another source installation or included in a payload fingerprint.
+Previously declared preserved paths remain protected when a later release omits
+them. Runtime links are rejected instead of following their targets.
+
+The new copy is staged beside the provider directory and activated through
+`PathGuard.swap_in_scope`. Only the exact owned scope entry is renamed or removed;
+link targets are retained. A failed activation restores the previous entry. If a
+foreign entry appears during rollback, both the foreign entry and the original
+backup are retained and the error identifies the recovery blocker. Store
+materialization and scope activation are separate transactions: a failed scope
+activation can leave the verified new source version in the store while the old
+copy remains readable. Retrying updates the scope from that verified source.
+
+Direct `link_existing` uses the same checks. `migrate_scope` retains readable
+managed copy projections and reports them in `skipped_projection`. Legacy copy
+migration requires ownership metadata and a prior release manifest whose raw
+hashes match every payload file. Unknown bytes or namesake metadata are left
+unchanged. Recovery requires a verified pinned previous hub manifest/bundle or an
+explicit manual review and export; `force` cannot establish a baseline.
+
+## Codex runtime home
+
+With an explicit absolute `CODEX_HOME`, the Codex target places global skills at
+`$CODEX_HOME/skills` and global MCP settings at `$CODEX_HOME/config.toml`. It does
+not claim unrelated sibling legacy directories. An injected `root=` continues to
+override the environment for isolated callers and tests, and `config_root=` can
+explicitly override the configuration path.
+
+When `CODEX_HOME` is unset, the existing global `.agents/skills`, `.codex` config,
+and managed legacy lookup remain unchanged. Project skills still use
+`<project>/.agents/skills`, and project MCP configuration still uses
+`<project>/.codex/config.toml`. Paths must be absolute in the current operating
+system's syntax; a Windows drive path is not silently treated as a Linux relative
+directory.

s_skillkit-0.6.2/docs/safe-updates.md

@@ -0,0 +1,41 @@
+# Safe updates of hub-managed skills
+
+Existing hub payload is checked against the SHA-256 inventory of its installed
+published version before materialization and again before the staged version
+replaces the store. The same check protects a managed copy in the agent scope.
+An unchanged symlink or Windows junction to the store is a projection and is
+checked through the store instead.
+
+Modified or deleted files, file type changes, payload links, and untracked
+payload that could be overwritten or filtered out stop the complete update.
+An update also stops when its old inventory is missing, malformed, or cannot
+be read. A new manifest cannot hide edited payload by declaring it preserved.
+The `force` option does not bypass these checks.
+
+For `SkillStore.install(...)`, the result has `skipped=True`, one of
+`skip_reason="local-modifications"` or `"unverifiable-baseline"`, and safe
+relative `conflict_paths`. A path of `.` denotes an unavailable baseline or
+conflict at the installation root. No version, metadata, scope link, or payload
+is replaced. Consumers must skip tooling and must report the reason to the
+user. `SkillStore.materialize(...)` uses the same guard and returns a dictionary
+with `skipped`, `skip_reason`, and `conflict_paths` on refusal; consumers should
+check this before reading the normal success fields.
+
+The comparison is byte-exact. LF/CRLF conversion is a modification and is not
+silently normalized. Existing Git-based Windows installs with line-ending
+conversion need a separately verified recovery process. A trusted old baseline
+must come from the immutable installed version or its verified snapshot, never
+from hashing the currently edited installation. New local edits should be
+committed and released from an author's source repository rather than made in
+the managed store.
+
+Declared runtime state and installer/runtime artifacts (`.git`, `.pkgsrc`,
+`.venv`, `__pycache__`, and `_skill_meta.json`) are outside this payload hash
+check. Their existing lifecycle is unchanged. A malformed or missing baseline
+is not repaired automatically. Generated stub-over-stub updates keep their
+existing behavior because they have no published payload inventory.
+
+This guard checks state again immediately before swapping staged content. It
+does not provide a filesystem transaction against an uncoordinated writer
+changing files during the final check/swap or against other concurrent
+installers; callers still need to serialize installation work.

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

@@ -1,6 +1,6 @@
 [project]
 name = "s-skillkit"
-version = "0.5.0"
+version = "0.6.2"
 description = "Локальное ядро управления навыками: install из git/локальной папки, junction/symlink-линковка в scope агента, .skillignore-фильтр, build manifest, project-манифест. 0 завязок на сеть/auth — stdlib + tomli-w + pathspec + platformdirs."
 readme = "README.md"
 license = { text = "MIT" }
@@ -25,10 +25,15 @@ authors = [{ name = "Dmitry" }]
 #   ответственность ИМЕННО этого кита. Зависимость лёгкая: telemetrykit
 #   stdlib-only и своих зависимостей не имеет.
 dependencies = [
+    # Объявлено ПРЯМО (гейт зависимостей, #2834): кит импортирует пакет сам,
+    # а приезжал он транзитивно. Прямой импорт на чужой зависимости живёт до
+    # дня, когда сосед сменит свой набор, — и падает ModuleNotFoundError в
+    # бою при зелёной сборке.
+    "typer>=0.15",
     "tomli-w>=1.0",
     "pathspec>=0.12.0",
     "platformdirs>=4.0",
-    "s-telemetrykit>=0.2.0",
+    "s-telemetrykit>=0.2.0,<0.4",
 ]
 
 #: installer_cli (волна 5, #2710) — бывший псевдокит installerkit, консолидирован
@@ -40,7 +45,11 @@ dependencies = [
 #: `pip install s-skillkit[installer_cli]`. Модуль и не импортируется eagerly
 #: из ``skillkit/__init__.py`` (тот же приём, что у ``skillkit.telemetry``).
 [project.optional-dependencies]
-installer_cli = ["s-clikit>=0.1.6", "s-librarykit<0.9"]
+# s-skillgate объявлен здесь же: `installer_cli/publish.py` зовёт
+# `from skillgate import run_gate` — секрет-скан перед публикацией.
+# Импорт ленивый, но без пакета публикация падает ровно в момент,
+# когда её и запускают (гейт #2834).
+installer_cli = ["s-clikit>=0.1.6,<0.3", "s-librarykit<0.9", "s-skillgate>=0.1.0,<0.2"]
 
 #: Инструменты прогона объявлены ГРУППОЙ, а не extra, намеренно (skl#2545).
 #: extra ставится только по явному `--extra dev`; забыли флаг — pytest в
@@ -94,3 +103,11 @@ ignore = ["RUF001", "RUF002", "RUF003", "RUF022", "RUF059"]
 asyncio_mode = "auto"
 testpaths = ["tests"]
 pythonpath = ["."]
+
+[tool.kit]
+# ОТКРЫТЫЙ. Это вспомогательная механика: из неё собирают, но сама по себе она
+# ничьей площадки и ничьего продукта не раскрывает.
+#
+# Признак читает шаг публикации: открытый кит уезжает на PyPI, приватный — в
+# приватный индекс GitLab. Граница держится машиной, а не памятью.
+visibility = "public"