s-skillkit 0.1.0__tar.gz

s_skillkit-0.1.0/.gitignore

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

s_skillkit-0.1.0/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.

s_skillkit-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,45 @@
+# 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/pyproject.toml

@@ -0,0 +1,48 @@
+[project]
+name = "s-skillkit"
+version = "0.1.0"
+description = "Локальное ядро управления навыками: install из git/локальной папки, junction/symlink-линковка в scope агента, .skillignore-фильтр, build manifest, project-манифест. 0 завязок на сеть/auth — stdlib + tomli-w + pathspec + platformdirs."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [{ name = "Dmitry" }]
+# skillkit — SIBLING librarykit (НЕ зависит от него, httpx, auth, сети).
+# Только локальная ФС-механика навыков. Core deps:
+# tomli-w — запись TOML (project-манифест .skills-hub/skills.toml,
+#   _skill_meta.toml ридеры используют stdlib tomllib на чтение);
+# pathspec — gitignore-стиль .skillignore / files-allowlist фильтр;
+# platformdirs — нативные дефолтные пути (Paths.default) по ОС.
+dependencies = [
+    "tomli-w>=1.0",
+    "pathspec>=0.12.0",
+    "platformdirs>=4.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-asyncio>=0.24"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["skillkit"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+src = ["."]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "N", "SIM", "RUF"]
+# RUF001/RUF002/RUF003 — кириллица в строках/докстрингах/комментах намеренная
+#   (русскоязычный код), ruff принимает её за «двусмысленную» латиницу.
+# RUF022 — __all__ сгруппирован по модулям с комментами осознанно.
+# RUF059 — распаковка кортежа в тестах с неиспользуемой частью (фикстура
+#   возвращает (store, target, store_dir); читаемее, чем индексирование).
+ignore = ["RUF001", "RUF002", "RUF003", "RUF022", "RUF059"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+pythonpath = ["."]

s_skillkit-0.1.0/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",
+]

s_skillkit-0.1.0/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()]