s-skillkit 0.1.0__py3-none-any.whl

s_skillkit-0.1.0.dist-info/METADATA

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: s-skillkit
+Version: 0.1.0
+Summary: Локальное ядро управления навыками: install из git/локальной папки, junction/symlink-линковка в scope агента, .skillignore-фильтр, build manifest, project-манифест. 0 завязок на сеть/auth — stdlib + tomli-w + pathspec + platformdirs.
+Author: Dmitry
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: tomli-w>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# s-skillkit
+
+Локальное ядро управления навыками (skills) — **SIBLING** `librarykit`
+(не зависит от него, от httpx, auth или сети). Только локальная ФС-механика.
+
+## Что внутри
+
+- **`SkillStore`** (`skillkit.installer`) — материализация навыка в центральный
+  стор и линковка (junction на Windows / symlink на POSIX) в scope агента:
+  - `install_from_git` / `install_from_path` / `install` / `materialize`
+  - `update` (инкрементальный sha-diff), `link_existing`, `migrate_scope`
+  - `remove` (keep-local / purge)
+  - P0 **stub-would-clobber guard** (stub не затирает живой контент).
+- **`targets`** — `IAgentTarget` + `detect_agent` / `get_target` (Claude Code,
+  Codex, Antigravity).
+- **`manifest`** — `build_manifest` для publish + ридеры frontmatter /
+  `_skill_meta.toml`.
+- **`filter`** — `.skillignore` / `files`-allowlist фильтр (pathspec).
+- **`project`** — проектный манифест `.skills-hub/skills.toml`.
+- **`Paths`** — инъекция каталогов (`store_dir` / `config_dir` / `bin_dir`).
+  `Paths.default()` — нативная раскладка через platformdirs.
+
+## Инъекция вместо завязки на конфиг
+
+Кит НЕ читает env/config. Каталоги передаются явным `Paths`; git-учётка —
+инъектируемым `credential_resolver` (callable `url -> url`). Потребитель (CLI)
+читает env-токен и собирает резолвер:
+
+```python
+from skillkit import SkillStore, Paths, get_target
+
+paths = Paths.default()  # или из ClientConfig
+
+def resolver(url: str) -> str:
+    token = os.environ.get("SKILLS_HUB_GIT_TOKEN")
+    if token and url.startswith("https://") and "@" not in url:
+        return url.replace("https://", f"https://oauth2:{token}@", 1)
+    return url
+
+store = SkillStore(get_target(None), paths.store_dir, credential_resolver=resolver)
+```
+
+## Зависимости
+
+`tomli-w`, `pathspec`, `platformdirs`. requires-python `>=3.11`. MIT.

s_skillkit-0.1.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+skillkit/__init__.py,sha256=IngF8P1XxBWAuI92A3V92UgRjIvi3AkRi45zleAuT-0,2869
+skillkit/collections.py,sha256=WjU0xqbDb_YKvazrQp5Yf1ciWdrWYBvW00UEFxZ7_tg,7329
+skillkit/deps_installer.py,sha256=i6Ql5e61TVP3-P40p0KS2anE6abPyvBCpuEwaqiGRqo,7681
+skillkit/filter.py,sha256=r_LxABjAyKDV_Lgsiy8FmEmVbXByWfCU2MhrNlsErHE,9950
+skillkit/installer.py,sha256=8Eqn0zir1Vparu5MzSGF_dpSmf6qVA0RuBLu9OUs19Q,43654
+skillkit/linker.py,sha256=BANKoQu_ddV1cVS3spRSPV0jnWPGMllnrHQpAT5yCR0,4731
+skillkit/manifest.py,sha256=iddSN_vzQOKBenEbX6s-QMpztumeJCijG-fPSRxuDUs,6007
+skillkit/mcp_register.py,sha256=Ue8h2E9_SjjAOFPK8JciC1s1Y6ufAckcHID3IBhzj1Y,11028
+skillkit/path_store.py,sha256=foo5AEmKpC8SdLJehYX5W7rudpgjmFfsxd9n36POXF8,16615
+skillkit/paths.py,sha256=Er8Gob7TM70zRpNqaElBwvnwG_3nnENGa98SKGVaTfY,2157
+skillkit/project.py,sha256=wCJzKDcKcd2aQqu7Tri7oMqtxkoJhZzfkxRVhFR7Eq8,1780
+skillkit/tooling.py,sha256=0Fo2f6m39SVAP1dKEq5UIrzXHFkzA-PQeKOsVmc29YY,10969
+skillkit/targets/__init__.py,sha256=Ut_10rxgN8WpUwk7ZADgJ78tpEKmLvFkLY5PljbX10E,488
+skillkit/targets/antigravity.py,sha256=nRiCcqYmSdklH8sPPWUrGOPb2rXoOhCIED44FwK-8tM,875
+skillkit/targets/base.py,sha256=sanSHnkYGZhYWobzC4x6DxmGpX2cSMez3_XiHax4eg8,3384
+skillkit/targets/claude_code.py,sha256=rlEjPHx8N3aFwvKwgOdoaXtMhC82AkoVOr-2HKghtWI,178
+skillkit/targets/codex.py,sha256=JMw0FcAsAtiMNfu_WtR9gUsrnTtblO6n11gSw47KPWo,166
+skillkit/targets/detect.py,sha256=hKhByKWXgPcy-KSc3onzPqp7si8TKFDKs5R_wrvFj8E,942
+s_skillkit-0.1.0.dist-info/METADATA,sha256=XTI3GKd6_UG1yoUX0AywivVt2H8FYiNdaGL9I5QCcyU,2917
+s_skillkit-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+s_skillkit-0.1.0.dist-info/licenses/LICENSE,sha256=j9GKJmUNdQuKRUbKhbpv0uyMaL99xsxE6L2TDtXuaZ4,1063
+s_skillkit-0.1.0.dist-info/RECORD,,

s_skillkit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

s_skillkit-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dmitry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

skillkit/__init__.py

@@ -0,0 +1,99 @@
+"""skillkit — локальное ядро управления навыками (SIBLING librarykit).
+
+0 завязок на сеть/auth/librarykit: только stdlib + tomli-w + pathspec +
+platformdirs. Отвечает за ФС-механику навыка:
+
+- ``SkillStore`` — материализация навыка в центральный стор (git clone /
+  локальная папка / stub) + junction/symlink-линковка в scope агента,
+  инкрементальный update по sha-diff, remove/keep-local/purge, migrate_scope.
+  Включает P0 stub-would-clobber guard.
+- ``targets`` — ``IAgentTarget`` + детект агента (Claude Code / Codex /
+  Antigravity).
+- ``manifest`` — build manifest для publish + ридеры frontmatter / _skill_meta.toml.
+- ``filter`` — .skillignore / files-allowlist фильтр.
+- ``project`` — проектный манифест ``.skills-hub/skills.toml``.
+- ``Paths`` — инъекция файловых каталогов (store/config/bin) вместо завязки на
+  конфиг потребителя.
+
+Хаб-специфика (track_skill_event, install-by-slug bundle, /me/installs) живёт в
+CLI, НЕ здесь.
+"""
+from __future__ import annotations
+
+from skillkit import (
+    collections,
+    deps_installer,
+    filter,
+    linker,
+    manifest,
+    mcp_register,
+    path_store,
+    project,
+    targets,
+    tooling,
+)
+from skillkit.collections import LocalCollectionError
+from skillkit.installer import (
+    CredentialResolver,
+    InstallResult,
+    PathTraversalError,
+    RemoveResult,
+    SkillInstaller,
+    SkillStore,
+    read_meta,
+    safe_copy_tree,
+    skill_dir_name,
+    write_meta,
+)
+from skillkit.manifest import BuiltManifest, build_manifest, git_commit_sha
+from skillkit.paths import Paths
+from skillkit.targets import (
+    AntigravityTarget,
+    BaseAgentTarget,
+    ClaudeCodeTarget,
+    CodexTarget,
+    IAgentTarget,
+    detect_agent,
+    get_target,
+)
+
+__all__ = [
+    # Paths-инъекция
+    "Paths",
+    # стор / установщик
+    "SkillStore",
+    "SkillInstaller",
+    "InstallResult",
+    "RemoveResult",
+    "CredentialResolver",
+    "PathTraversalError",
+    "safe_copy_tree",
+    "read_meta",
+    "write_meta",
+    "skill_dir_name",
+    # targets
+    "IAgentTarget",
+    "BaseAgentTarget",
+    "ClaudeCodeTarget",
+    "CodexTarget",
+    "AntigravityTarget",
+    "detect_agent",
+    "get_target",
+    # manifest
+    "BuiltManifest",
+    "build_manifest",
+    "git_commit_sha",
+    # локальные коллекции
+    "LocalCollectionError",
+    # подмодули (ФС-механика навыка)
+    "linker",
+    "filter",
+    "manifest",
+    "project",
+    "targets",
+    "path_store",
+    "tooling",
+    "deps_installer",
+    "mcp_register",
+    "collections",
+]

skillkit/collections.py

@@ -0,0 +1,179 @@
+"""Локальные коллекции навыков — БЕЗ хаба и сети.
+
+Хранилище: ``<config_dir>/collections.toml`` — та же папка, что config
+потребителя. skillkit НЕ читает env/config: каталог приходит от потребителя
+через ``Paths`` (инъекция). Standalone-дефолт — ``Paths.default().config_dir``;
+CLI переопределяет провайдер (``set_config_dir_provider``), чтобы учесть свой
+``SKILLS_HUB_CONFIG_DIR`` и профили ``--profile``.
+
+Формат:
+    [collections.<name>]
+    title = "…"
+    skills = ["slug1", "slug2"]
+
+Имя коллекции — slug-подобное (буквы/цифры/``-``/``_``): оно становится ключом
+toml-таблицы. Слаги навыков НЕ валидируются против хаба — коллекция может
+ссылаться на навыки, которых (ещё) нет в локальном сторе.
+"""
+from __future__ import annotations
+
+import re
+import tomllib
+from collections.abc import Callable
+from pathlib import Path
+from typing import Any
+
+import tomli_w
+
+from skillkit.paths import Paths
+
+_NAME_RE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9_-]*$")
+
+
+class LocalCollectionError(ValueError):
+    """Ожидаемая ошибка операции: ``code`` + ``message`` для ``emit_error``."""
+
+    def __init__(self, code: str, message: str) -> None:
+        super().__init__(message)
+        self.code = code
+        self.message = message
+
+
+# --------------------------------------------------------------------------
+#  config_dir — провайдер каталога (инъекция от потребителя)
+# --------------------------------------------------------------------------
+def _default_config_dir() -> Path:
+    """Standalone-дефолт: нативный config-каталог через platformdirs."""
+    return Paths.default().config_dir
+
+
+_config_dir_provider: Callable[[], Path] = _default_config_dir
+
+
+def set_config_dir_provider(provider: Callable[[], Path]) -> None:
+    """Задать провайдер config-каталога (точка инъекции для CLI/потребителя)."""
+    global _config_dir_provider
+    _config_dir_provider = provider
+
+
+def collections_path() -> Path:
+    """Путь файла локальных коллекций (рядом с config потребителя)."""
+    return _config_dir_provider() / "collections.toml"
+
+
+def _normalize(body: dict[str, Any], name: str) -> dict[str, Any]:
+    """Приводит запись к канону {title: str, skills: [str]} (дедуп слагов)."""
+    skills: list[str] = []
+    for s in body.get("skills") or []:
+        s_str = str(s).strip()
+        if s_str and s_str not in skills:
+            skills.append(s_str)
+    return {"title": str(body.get("title") or name), "skills": skills}
+
+
+def load_all() -> dict[str, dict[str, Any]]:
+    """{name: {"title": str, "skills": [slug, ...]}}; пусто если файла нет."""
+    p = collections_path()
+    if not p.exists():
+        return {}
+    try:
+        # utf-8-sig — толерантность к BOM (как ClientConfig.load).
+        data = tomllib.loads(p.read_text(encoding="utf-8-sig"))
+    except tomllib.TOMLDecodeError as e:
+        raise LocalCollectionError("PARSE", f"{p} повреждён: {e}") from e
+    raw = data.get("collections") or {}
+    out: dict[str, dict[str, Any]] = {}
+    for name, body in raw.items():
+        if isinstance(body, dict):
+            out[str(name)] = _normalize(body, str(name))
+    return out
+
+
+def save_all(collections: dict[str, dict[str, Any]]) -> None:
+    """Пишет весь набор (ключи сортируются для стабильного diff)."""
+    p = collections_path()
+    p.parent.mkdir(parents=True, exist_ok=True)
+    ordered = {n: _normalize(collections[n], n) for n in sorted(collections)}
+    p.write_text(tomli_w.dumps({"collections": ordered}), encoding="utf-8")
+
+
+def validate_name(name: str) -> None:
+    if not _NAME_RE.match(name or ""):
+        raise LocalCollectionError(
+            "VALIDATION",
+            f"Имя коллекции «{name}» некорректно: допустимы буквы/цифры/«-»/«_» "
+            "(без пробелов), первый символ — буква или цифра",
+        )
+
+
+def get(name: str) -> dict[str, Any] | None:
+    """Коллекция по имени либо None."""
+    return load_all().get(name)
+
+
+def create(name: str, *, title: str | None = None) -> dict[str, Any]:
+    """Создаёт пустую коллекцию. ALREADY_EXISTS если имя занято."""
+    validate_name(name)
+    collections = load_all()
+    if name in collections:
+        raise LocalCollectionError(
+            "ALREADY_EXISTS", f"Локальная коллекция «{name}» уже существует"
+        )
+    collections[name] = {"title": title or name, "skills": []}
+    save_all(collections)
+    return collections[name]
+
+
+def delete(name: str) -> dict[str, Any]:
+    """Удаляет коллекцию (установленные навыки не трогает). NOT_FOUND если нет."""
+    collections = load_all()
+    if name not in collections:
+        raise LocalCollectionError(
+            "NOT_FOUND", f"Локальная коллекция «{name}» не найдена"
+        )
+    removed = collections.pop(name)
+    save_all(collections)
+    return removed
+
+
+def add_skill(name: str, slug: str) -> tuple[dict[str, Any], bool]:
+    """(коллекция, added). added=False если слаг уже был (идемпотентно)."""
+    slug = str(slug or "").strip()
+    if not slug:
+        raise LocalCollectionError("VALIDATION", "Слаг навыка пуст")
+    collections = load_all()
+    if name not in collections:
+        raise LocalCollectionError(
+            "NOT_FOUND", f"Локальная коллекция «{name}» не найдена"
+        )
+    coll = collections[name]
+    if slug in coll["skills"]:
+        return coll, False
+    coll["skills"].append(slug)
+    save_all(collections)
+    return coll, True
+
+
+def remove_skill(name: str, slug: str) -> tuple[dict[str, Any], bool]:
+    """(коллекция, removed). removed=False если слага не было."""
+    collections = load_all()
+    if name not in collections:
+        raise LocalCollectionError(
+            "NOT_FOUND", f"Локальная коллекция «{name}» не найдена"
+        )
+    coll = collections[name]
+    if slug not in coll["skills"]:
+        return coll, False
+    coll["skills"] = [s for s in coll["skills"] if s != slug]
+    save_all(collections)
+    return coll, True
+
+
+def missing_in_store(skills: list[str], store_dir: Path) -> list[str]:
+    """Слаги, которых нет в локальном сторе.
+
+    Критерий «есть в сторе» тот же, что у ``SkillStore.link_existing``:
+    существует каталог ``<store>/<slug>`` (для slug-less навыка — числовой id).
+    """
+    root = Path(store_dir)
+    return [s for s in skills if not (root / s).exists()]

skillkit/deps_installer.py

@@ -0,0 +1,185 @@
+"""Установка runtime-зависимостей навыка (tooling).
+
+Навык типа ``tooling`` может декларировать ``runtime_dependencies`` —
+список ``{kind, spec}``, где ``kind ∈ {pip, npm, system}``:
+
+- ``pip``    → ставим через **uv** (``uv pip install``) → fallback ``pip``
+  (``python -m pip install``). Нет ни uv, ни pip → НЕ падаем, кладём в
+  ``skipped`` с готовой инструкцией (graceful degradation);
+- ``npm``    → ставим через ``npm install -g`` только если ``npm`` есть в PATH;
+  иначе ``skipped`` + инструкция (node/npm — не наша забота ставить);
+- ``system`` → НИКОГДА не ставим сами (apt/brew/choco/права) — только
+  инструкция в ``skipped``.
+
+Идемпотентность — на менеджере пакетов (повторный install уже стоящего = no-op).
+Функция НИКОГДА не бросает: ошибка любой зависимости → она в ``failed``/
+``skipped``, остальные продолжают. Возврат::
+
+    {"installed": [{kind, spec}, ...],
+     "skipped":   [{kind, spec, reason, instruction}, ...],
+     "failed":    [{kind, spec, reason}, ...]}
+
+Кроссплатформенность: выбор менеджера — через ``shutil.which`` (обёрнут в
+``_which`` для мокабельности) + ``python -m pip`` (текущий интерпретатор,
+работает на win/mac/linux). subprocess-примитив ``_run`` тоже подменяем в тестах.
+"""
+from __future__ import annotations
+
+import shutil
+import subprocess
+import sys
+from typing import Any
+
+# kinds, которые умеем обрабатывать (прочее → skipped с reason unknown-kind).
+_KNOWN_KINDS = frozenset({"pip", "npm", "system"})
+
+
+# --------------------------------------------------------------------------
+#  Подменяемые в тестах примитивы окружения
+# --------------------------------------------------------------------------
+def _which(name: str) -> str | None:
+    """Путь к исполняемому ``name`` в PATH или None (обёртка для моков)."""
+    return shutil.which(name)
+
+
+def _pip_available() -> bool:
+    """Доступен ли ``pip`` для текущего интерпретатора (``python -m pip``)."""
+    try:
+        proc = subprocess.run(
+            [sys.executable, "-m", "pip", "--version"],
+            capture_output=True,
+            check=False,
+        )
+        return proc.returncode == 0
+    except OSError:
+        return False
+
+
+def _run(cmd: list[str]) -> int:
+    """Запустить команду установки, вернуть returncode (не бросает на OSError)."""
+    try:
+        return subprocess.run(cmd, check=False).returncode
+    except OSError:
+        return 127
+
+
+# --------------------------------------------------------------------------
+#  Public API
+# --------------------------------------------------------------------------
+def install_runtime_dependencies(
+    deps: list[dict[str, Any]] | tuple[dict[str, Any], ...] | None,
+) -> dict[str, list[dict[str, Any]]]:
+    """Поставить runtime-зависимости навыка. Никогда не бросает.
+
+    ``deps`` — список ``{"kind": pip|npm|system, "spec": "..."}`` (как в манифесте
+    ``runtime_dependencies`` / ``aggregated_runtime_dependencies``). Кривые
+    элементы (не-dict, без kind/spec, неизвестный kind) пропускаются/идут в
+    skipped. Возвращает отчёт ``{installed, skipped, failed}``.
+    """
+    report: dict[str, list[dict[str, Any]]] = {
+        "installed": [],
+        "skipped": [],
+        "failed": [],
+    }
+    if not deps:
+        return report
+
+    for raw in deps:
+        if not isinstance(raw, dict):
+            continue  # мусор — игнор
+        kind = raw.get("kind")
+        spec = raw.get("spec")
+        if not kind or not spec:
+            continue  # неполная декларация — игнор
+        kind = str(kind)
+        spec = str(spec)
+        if kind not in _KNOWN_KINDS:
+            report["skipped"].append(
+                {
+                    "kind": kind,
+                    "spec": spec,
+                    "reason": f"неизвестный kind зависимости: {kind}",
+                    "instruction": f"установите {spec} вручную ({kind}).",
+                }
+            )
+            continue
+        _dispatch(kind, spec, report)
+    return report
+
+
+def _dispatch(
+    kind: str, spec: str, report: dict[str, list[dict[str, Any]]]
+) -> None:
+    """Маршрутизация одной зависимости по kind в нужную ветку установки."""
+    if kind == "pip":
+        _install_pip(spec, report)
+    elif kind == "npm":
+        _install_npm(spec, report)
+    else:  # system
+        report["skipped"].append(
+            {
+                "kind": "system",
+                "spec": spec,
+                "reason": "системная зависимость не ставится автоматически",
+                "instruction": (
+                    f"установите системный пакет «{spec}» вашим пакетным "
+                    "менеджером (apt/brew/choco/...)."
+                ),
+            }
+        )
+
+
+# --------------------------------------------------------------------------
+#  pip: uv pip install → python -m pip install
+# --------------------------------------------------------------------------
+def _install_pip(spec: str, report: dict[str, list[dict[str, Any]]]) -> None:
+    entry = {"kind": "pip", "spec": spec}
+    if _which("uv") is not None:
+        cmd = ["uv", "pip", "install", spec]
+    elif _pip_available():
+        cmd = [sys.executable, "-m", "pip", "install", spec]
+    else:
+        report["skipped"].append(
+            {
+                **entry,
+                "reason": "не найдены ни uv, ни pip",
+                "instruction": (
+                    f"установите uv (https://docs.astral.sh/uv/) или pip, затем "
+                    f"`pip install {spec}`."
+                ),
+            }
+        )
+        return
+    rc = _run(cmd)
+    if rc == 0:
+        report["installed"].append(entry)
+    else:
+        report["failed"].append(
+            {**entry, "reason": f"менеджер вернул код {rc}"}
+        )
+
+
+# --------------------------------------------------------------------------
+#  npm: npm install -g (только если npm есть)
+# --------------------------------------------------------------------------
+def _install_npm(spec: str, report: dict[str, list[dict[str, Any]]]) -> None:
+    entry = {"kind": "npm", "spec": spec}
+    if _which("npm") is None:
+        report["skipped"].append(
+            {
+                **entry,
+                "reason": "npm не найден в PATH",
+                "instruction": (
+                    f"установите Node.js/npm (https://nodejs.org), затем "
+                    f"`npm install -g {spec}`."
+                ),
+            }
+        )
+        return
+    rc = _run(["npm", "install", "-g", spec])
+    if rc == 0:
+        report["installed"].append(entry)
+    else:
+        report["failed"].append(
+            {**entry, "reason": f"npm вернул код {rc}"}
+        )