s-skillkit 0.3.4__tar.gz → 0.3.6__tar.gz

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/CHANGELOG.md

@@ -4,6 +4,71 @@
 [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/); версионирование —
 [SemVer](https://semver.org/lang/ru/).
 
+## [0.3.6]
+
+### Changed — своя политика запуска подпроцессов, s-librarykit убран (#1644)
+
+- **Кит перестал тянуть `s-librarykit`.** Зависимость стояла ТОЛЬКО ради
+  `librarykit.proc` (восемь вызовов `run`), а вместе с ней в установку приезжали
+  httpx / cryptography / keyring — сетевой и криптографический стек в ките,
+  который в манифесте обещает «stdlib + tomli-w + pathspec + platformdirs», в
+  сеть не ходит и про auth не знает. Обещание манифеста и факт установки
+  разъезжались.
+- **Появился `skillkit.proc` — перенесённый МИНИМУМ на stdlib.** Ровно то, что
+  кит реально зовёт: синхронный `run` с `timeout` (обязательный keyword-only),
+  `cwd`, `log`, `check`; `CREATE_NO_WINDOW` на Windows; `ProcResult` с
+  `ok`/`timed_out`. НЕ переносились долгоживущий `popen`, `env`, `text=False`,
+  `allow_console` и полный движок маскировки — ни один вызов кита их не
+  использует, а мёртвый код пришлось бы поддерживать. Маскировка сведена к тому,
+  что здесь действительно нужно: креды внутри URL (`git clone` по URL с токеном).
+- **Форма результата сохранена один в один**, поэтому вызывающий код (bootstrap,
+  deps_installer, fetchers, linker, manifest, tooling, uv_bootstrap) не менялся —
+  только импорт. Прежний seam тестов (`monkeypatch` на `subprocess.run`) тоже
+  продолжает работать: `skillkit.proc` зовёт тот же stdlib-модуль.
+- **Гейты.** Allowlist «прямого subprocess» теперь содержит ровно один модуль —
+  сам `skillkit/proc.py`; добавлены тесты, что `librarykit` не вернётся ни в
+  зависимости `pyproject.toml`, ни в импорты пакета.
+
+## [0.3.5]
+
+### Changed — shim навыка ведёт вызов через раннер учёта (#1221)
+
+- **Учёт вызова навыка стал НЕОБХОДИМЫМ, а не зависящим от модели.** Раньше
+  событие «навыком воспользовались» появлялось, только если LLM вспоминала
+  позвать обёртку — метрика «запуски» фактически равнялась числу установок.
+  Теперь shim, который кладёт `add_cli`, зовёт раннер потребителя:
+  `<runner> run <skill_slug> --command <command_name> <аргументы как есть>`.
+  Учёт срабатывает при ЛЮБОМ вызове (`vk …`, `atlas …`), включая уже
+  опубликованные навыки — их `SKILL.md` править не нужно.
+- **Fallback обязателен.** Кит самостоятелен и может использоваться без CLI.
+  Проверка «есть ли раннер в PATH» делается ВНУТРИ shim'а (`where` на Windows,
+  `command -v` на POSIX), а не при генерации: PATH меняется после установки.
+  Нет раннера → прямой вызов entrypoint, как раньше. Навык не имеет права
+  перестать работать из-за отсутствия учёта.
+- **Антирекурсия.** Раннер обязан запускать entrypoint из sidecar'а НАПРЯМУЮ
+  (sidecar по-прежнему хранит прямой entrypoint — это источник правды) и
+  выставлять дочернему процессу маркер `<APP>_RUN_ACTIVE`. Shim, увидев маркер,
+  уходит на прямой вызов. Без обоих предохранителей пара «shim → раннер → shim»
+  зациклилась бы и положила машину пользователя.
+- **POSIX-shim больше НЕ symlink.** Даже на исполняемый entrypoint ставится
+  скрипт: symlink не носит логики и не может ни позвать раннер, ни проверить
+  маркер. `kind` в sidecar на POSIX теперь всегда `script`.
+- **Новое: `path_store.regenerate_shims()`** — перегенерация шимов из
+  sidecar'ов. Нужна потому, что у пользователей УЖЕ лежат шимы старого формата:
+  без неё учёт включился бы только для новых установок. Проход
+  самосходящийся (`only_stale=True` трогает лишь шимы, ещё не ведущие через
+  раннер), маркера «мигрировано» не требует, битый sidecar соседа пропускает.
+- **Новое в `SkillkitConfig`:** `runner_command` (None → `app_name`) и
+  `runner_guard_env` (None → выводится из имени раннера, `skillery` →
+  `SKILLERY_RUN_ACTIVE`). Точечные сеттеры — `path_store.set_runner`,
+  `path_store.runner_command()`, `path_store.guard_env_name()`.
+
+### Fixed
+
+- `__version__` в `skillkit/__init__.py` отстал от `pyproject.toml` (0.3.2 при
+  выпущенных 0.3.3/0.3.4) — синхронизирован. Расхождение версии в двух местах
+  уже однажды дало бесконечную петлю самообновления CLI.
+
 ## [Unreleased]
 
 ### Fixed — окна консоли, `.pkgsrc` в зоне агента, потеря происхождения снапшота

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s-skillkit
-Version: 0.3.4
+Version: 0.3.6
 Summary: Локальное ядро управления навыками: install из git/локальной папки, junction/symlink-линковка в scope агента, .skillignore-фильтр, build manifest, project-манифест. 0 завязок на сеть/auth — stdlib + tomli-w + pathspec + platformdirs.
 Author: Dmitry
 License: MIT
@@ -8,7 +8,6 @@ License-File: LICENSE
 Requires-Python: >=3.11
 Requires-Dist: pathspec>=0.12.0
 Requires-Dist: platformdirs>=4.0
-Requires-Dist: s-librarykit>=0.7.1
 Requires-Dist: s-telemetrykit>=0.2.0
 Requires-Dist: tomli-w>=1.0
 Provides-Extra: dev
@@ -127,6 +126,14 @@ version = "0.3.0"
 kind = "tooling"                 # prompt | comprehensive | tooling
 tags = ["pm", "cli"]
 
+# Release notes ЭТОЙ версии — «что изменилось». Опционально: нет поля — нет
+# release notes. Хаб сохраняет текст у версии навыка и показывает на странице
+# версий. Можно строкой (в т.ч. многострочной """...""") или списком пунктов.
+changelog = [
+    "Добавлен `atlas backlog` — пул сырых идей.",
+    "Починен триаж забытых задач.",
+]
+
 # ВАЖНО (TOML): top-level массивы объявляются ДО заголовков [[...]] —
 # иначе tomllib отнесёт ключ ВНУТРЬ таблицы, а не на верхний уровень.
 runtime_dependencies = [

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/README.md

@@ -109,6 +109,14 @@ version = "0.3.0"
 kind = "tooling"                 # prompt | comprehensive | tooling
 tags = ["pm", "cli"]
 
+# Release notes ЭТОЙ версии — «что изменилось». Опционально: нет поля — нет
+# release notes. Хаб сохраняет текст у версии навыка и показывает на странице
+# версий. Можно строкой (в т.ч. многострочной """...""") или списком пунктов.
+changelog = [
+    "Добавлен `atlas backlog` — пул сырых идей.",
+    "Починен триаж забытых задач.",
+]
+
 # ВАЖНО (TOML): top-level массивы объявляются ДО заголовков [[...]] —
 # иначе tomllib отнесёт ключ ВНУТРЬ таблицы, а не на верхний уровень.
 runtime_dependencies = [

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "s-skillkit"
-version = "0.3.4"
+version = "0.3.6"
 description = "Локальное ядро управления навыками: install из git/локальной папки, junction/symlink-линковка в scope агента, .skillignore-фильтр, build manifest, project-манифест. 0 завязок на сеть/auth — stdlib + tomli-w + pathspec + platformdirs."
 readme = "README.md"
 license = { text = "MIT" }
@@ -12,12 +12,12 @@ authors = [{ name = "Dmitry" }]
 #   _skill_meta.toml ридеры используют stdlib tomllib на чтение);
 # pathspec — gitignore-стиль .skillignore / files-allowlist фильтр;
 # platformdirs — нативные дефолтные пути (Paths.default) по ОС;
-# s-librarykit — ТОЛЬКО ради ``librarykit.proc`` (#1144): единая политика запуска
-#   подпроцессов. Кит запускает uv/git/npm/powershell, а на Windows консольный
-#   ребёнок демона (у него нет своей консоли) без CREATE_NO_WINDOW получает
-#   ВИДИМОЕ окно поверх браузера; ``capture_output`` его не подавляет. Своей
-#   второй реализации «как правильно на Windows» в ките быть не должно —
-#   поэтому прежний статус «sibling, ни от чего не зависим» осознанно снят.
+# s-librarykit УБРАН (#1644): он тянулся ТОЛЬКО ради ``librarykit.proc``, а с
+#   ним приезжали httpx / cryptography / keyring — сетевой и криптографический
+#   стек в ките, который в сеть не ходит и про auth не знает. Нужный минимум
+#   (CREATE_NO_WINDOW + обязательный таймаут + ProcResult) перенесён в
+#   ``skillkit.proc`` на голом stdlib-``subprocess``; форма результата
+#   сохранена, вызывающий код не менялся.
 # s-telemetrykit — продуктово-нейтральный SDK учёта запусков. Кит нейтрален
 #   намеренно (он переиспользуем в любом продукте), поэтому skillery-специфику
 #   телеметрии — каталог ~/.skillery, префикс SKILLERY_*, канон _skill_meta.* и
@@ -28,7 +28,6 @@ dependencies = [
     "tomli-w>=1.0",
     "pathspec>=0.12.0",
     "platformdirs>=4.0",
-    "s-librarykit>=0.7.1",
     "s-telemetrykit>=0.2.0",
 ]
 

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/skillkit/__init__.py

@@ -1,7 +1,10 @@
 """skillkit — локальное ядро управления навыками (SIBLING librarykit).
 
 0 завязок на сеть/auth/librarykit: только stdlib + tomli-w + pathspec +
-platformdirs. Отвечает за ФС-механику навыка:
+platformdirs. Запуск подпроцессов (uv/git/cmd/powershell) — свой ``skillkit.proc``
+на stdlib (#1644): тянуть ради него весь ``s-librarykit`` значило приводить в
+кит httpx/cryptography/keyring, которым тут делать нечего.
+Отвечает за ФС-механику навыка:
 
 - ``SkillStore`` — материализация навыка в центральный стор (git clone /
   локальная папка / stub) + junction/symlink-линковка в scope агента,
@@ -116,7 +119,7 @@ from skillkit.targets import (
 )
 from skillkit.uv_bootstrap import ensure_uv
 
-__version__ = "0.3.2"
+__version__ = "0.3.5"
 
 __all__ = [
     "__version__",

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/skillkit/bootstrap.py

@@ -24,7 +24,7 @@ s-xray-gate). Кит НЕ зависит от него жёстко: это ``Ca
 
 Мокабельность: запуск идёт через ``_run_cmd`` (uv sync) и ``_run_capture``
 (self_check); поиск uv — через ``_which``; ОС — константа ``IS_WINDOWS``.
-Оба примитива — обёртки над ``librarykit.proc.run`` (#1144): на Windows он
+Оба примитива — обёртки над ``skillkit.proc.run`` (#1144): на Windows он
 всегда ставит ``CREATE_NO_WINDOW`` (bootstrap зовёт демон, у которого нет своей
 консоли — иначе окна поверх браузера) и требует явный таймаут.
 """
@@ -37,11 +37,9 @@ from collections.abc import Callable
 from pathlib import Path
 from typing import Any
 
-from librarykit import proc
-from librarykit.proc import ProcResult
-
-from skillkit import deps_installer, uv_bootstrap
+from skillkit import deps_installer, proc, uv_bootstrap
 from skillkit.deps_installer import _BINARY_KINDS
+from skillkit.proc import ProcResult
 
 IS_WINDOWS = sys.platform == "win32"
 
@@ -145,7 +143,7 @@ def run_self_check(skill_dir: Path | str) -> tuple[bool, str]:
     script = skill_dir / "scripts" / "self_check.py"
     if not script.exists():
         return (False, f"scripts/self_check.py не найден в {skill_dir}")
-    # Имя ``result``, а не ``proc``: модульный ``proc`` — это librarykit.proc.
+    # Имя ``result``, а не ``proc``: модульный ``proc`` — это skillkit.proc.
     result = _run_capture(_self_check_command(skill_dir, script), cwd=skill_dir)
     output = (result.stdout or "") + (result.stderr or "")
     return (result.returncode == 0, output)

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/skillkit/config.py

@@ -59,6 +59,12 @@ class SkillkitConfig:
     rc_marker: str | None = None
     clone_prefix: str | None = None
     managed_by: str | None = None
+    # Раннер учёта вызовов навыка (#1221): исполняемое, которое зовёт shim как
+    # ``<runner> run <slug> --command <name> …``. None → app_name (у skillery
+    # это и есть имя CLI). ``runner_guard_env`` — маркер антирекурсии, None →
+    # выводится из имени раннера (``skillery`` → ``SKILLERY_RUN_ACTIVE``).
+    runner_command: str | None = None
+    runner_guard_env: str | None = None
     # Ленивые провайдеры каталогов (None → нативный platformdirs-дефолт).
     config_dir_provider: Callable[[], Path] | None = None
     bin_dir_provider: Callable[[], Path] | None = None
@@ -71,6 +77,10 @@ class SkillkitConfig:
         """Префикс временной папки git-clone (производный или явный)."""
         return self.clone_prefix or f"{self.app_name}-clone-"
 
+    def resolved_runner_command(self) -> str:
+        """Исполняемое раннера учёта вызовов (производное или явное)."""
+        return self.runner_command or self.app_name
+
     def resolved_managed_by(self) -> str:
         """Владелец управляемых папок (производный или явный)."""
         return self.managed_by or self.app_name
@@ -98,8 +108,11 @@ def configure(config: SkillkitConfig) -> None:
         project.set_manifest_rel_provider(project._default_manifest_rel)
     project.set_manifest_fallbacks(config.manifest_fallbacks)
 
-    # 3. PATH-интеграция: rc-маркер + ленивый bin-каталог.
+    # 3. PATH-интеграция: rc-маркер + ленивый bin-каталог + раннер учёта.
     path_store.set_rc_marker(config.resolved_rc_marker())
+    path_store.set_runner(
+        config.resolved_runner_command(), guard_env=config.runner_guard_env
+    )
     path_store.set_bin_dir_provider(
         config.bin_dir_provider or path_store._default_bin_dir
     )

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/skillkit/deps_installer.py

@@ -29,7 +29,7 @@
 ``_which`` для мокабельности) + ``python -m pip`` (текущий интерпретатор,
 работает на win/mac/linux). Примитив запуска ``_run`` тоже подменяем в тестах.
 
-Запуск идёт ТОЛЬКО через ``librarykit.proc.run`` (#1144): на Windows он всегда
+Запуск идёт ТОЛЬКО через ``skillkit.proc.run`` (#1144): на Windows он всегда
 ставит ``CREATE_NO_WINDOW`` (иначе фоновая установка навыка демоном рисует
 пользователю окна ``uv.EXE`` поверх браузера) и требует явный таймаут — висящий
 ``uv`` в демоне некому прервать. Заодно снят прежний дефект: ``uv pip install``
@@ -43,9 +43,7 @@ import sys
 from pathlib import Path
 from typing import Any
 
-from librarykit import proc
-
-from skillkit import binary_installer
+from skillkit import binary_installer, proc
 from skillkit.pkg_manager import detect_project, missing_manager_report
 
 _LOG = logging.getLogger(__name__)

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/skillkit/installer/__init__.py

@@ -30,7 +30,7 @@ import contextlib
 import logging
 
 # re-export seam: тесты патчат installer.subprocess.run. Сам кит подпроцессы
-# НЕ запускает напрямую (#1144) — их гоняет ``librarykit.proc.run``, который
+# НЕ запускает напрямую (#1144) — их гоняет ``skillkit.proc.run``, который
 # внутри зовёт этот же stdlib-``subprocess``, поэтому патч продолжает работать.
 import subprocess  # noqa: F401
 import tarfile

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/skillkit/installer/fetchers.py

@@ -6,7 +6,7 @@
 позволяет подменить получение источника (офлайн-зеркало, кеш, фейк в тестах)
 НЕ трогая оркестратор ``SkillStore``.
 
-Запуск git идёт через ``librarykit.proc.run`` (#1144) — единая политика окон и
+Запуск git идёт через ``skillkit.proc.run`` (#1144) — единая политика окон и
 таймаутов кита. Здесь исторически стоял ЕДИНСТВЕННЫЙ во всём ките
 ``CREATE_NO_WINDOW``; теперь флаг не дублируется в вызове, а приходит из ``proc``.
 
@@ -23,8 +23,7 @@ from collections.abc import Iterator
 from pathlib import Path
 from typing import Protocol, runtime_checkable
 
-from librarykit import proc
-
+from skillkit import proc
 from skillkit.errors import CloneError
 from skillkit.installer.fsops import _force_rmtree
 

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/skillkit/linker.py

@@ -19,13 +19,13 @@ import stat
 import sys
 from pathlib import Path
 
-from librarykit import proc
+from skillkit import proc
 
 IS_WINDOWS = sys.platform == "win32"
 
 _LOG = logging.getLogger(__name__)
 
-#: ``mklink /J`` — одна операция ФС; секунды. Запуск через ``librarykit.proc.run``
+#: ``mklink /J`` — одна операция ФС; секунды. Запуск через ``skillkit.proc.run``
 #: (#1144): ``cmd.exe`` из демона без консоли иначе мигает окном пользователю.
 _MKLINK_TIMEOUT = 30.0
 

{s_skillkit-0.3.4 → s_skillkit-0.3.6}/skillkit/manifest.py

@@ -16,7 +16,7 @@ from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any
 
-from librarykit import proc
+from skillkit import proc
 
 #: ``git rev-parse HEAD`` читает локальный .git — это секунды (#1144: запуск
 #: через ``proc.run``, на Windows без всплывающего окна консоли).
@@ -67,6 +67,10 @@ class BuiltManifest:
     # это пользователю/ИИ-агенту, чтобы тот сам довёл настройку до конца.
     # {"summary": str, "next_steps": [str, ...], "docs": str}
     onboarding: dict = field(default_factory=dict)
+    # Release notes ЭТОЙ версии — «что изменилось» (#1192). Свободный markdown
+    # либо список пунктов; хаб сохраняет его у версии навыка и показывает на
+    # странице версий. None ⇒ навык поле не объявил (норма).
+    changelog: str | None = None
 
 
 def _sha256_of(path: Path) -> str:
@@ -248,6 +252,25 @@ def _hooks(meta_toml: dict) -> list[dict]:
     return out
 
 
+def _changelog(meta_toml: dict, fm: dict) -> str | None:
+    """Release notes версии из ``_skill_meta.toml`` > frontmatter (#1192).
+
+    Контракт нормализации как у ``onboarding``/``hooks``: поля нет — пусто
+    (None), мусор не роняет сборку манифеста. Список пунктов склеивается
+    переносами: release notes в TOML удобно писать массивом строк.
+    """
+    raw = meta_toml.get("changelog")
+    if raw is None:
+        raw = fm.get("changelog")
+    if raw is None:
+        return None
+    if isinstance(raw, (list, tuple)):
+        text = "\n".join(str(x).strip() for x in raw if str(x).strip())
+    else:
+        text = str(raw).strip()
+    return text or None
+
+
 def build_manifest(skill_dir: Path, *, version: str) -> BuiltManifest:
     if not skill_dir.is_dir():
         raise FileNotFoundError(f"Skill папка не найдена: {skill_dir}")
@@ -359,4 +382,5 @@ def build_manifest(skill_dir: Path, *, version: str) -> BuiltManifest:
         runtime_dependencies=runtime_deps,
         onboarding=onboarding,
         hooks=_hooks(meta_toml),
+        changelog=_changelog(meta_toml, fm),
     )