s-clientkit 0.0.1__tar.gz → 0.1.0__tar.gz

{s_clientkit-0.0.1 → s_clientkit-0.1.0}/.gitignore

@@ -1,47 +1,47 @@
-# === 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
+# === 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

s_clientkit-0.1.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=cifropro1/products, project=clientkit,
+#   top-level pipeline file=.gitlab-ci.yml, environment — пусто).
+# Дистрибутив на PyPI: s-clientkit.
+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_clientkit-0.1.0/.importlinter

@@ -0,0 +1,65 @@
+# СГЕНЕРИРОВАНО из devcontour/tools/kits/template/importlinter.ini — не правь
+# здесь. Правка идёт в шаблон, затем `python tools/kits/apply_template.py <кит>`.
+#
+# Заготовка контракта слоёв. Запуск: `uv run --with import-linter lint-imports`.
+#
+# Контракт ниже — минимум, который годится ЛЮБОМУ киту и не требует ручной
+# настройки: «clientkit не импортирует те киты экосистемы, которых нет в его
+# объявленных зависимостях». Скрытая зависимость — это кит, который работает у
+# автора (сосед стоит в 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 =
+    clientkit
+exclude_type_checking_imports = True
+
+[importlinter:contract:no-undeclared-kits]
+name = clientkit не импортирует киты, которых нет в его зависимостях
+type = forbidden
+source_modules =
+    clientkit
+forbidden_modules =
+    accountpoolkit
+    agentskit
+    aichatkit
+    authkit_contracts
+    authkit_server
+    b24kit
+    browserkit
+    chatkit
+    clikit
+    emojikit
+    gitkit
+    installerkit
+    iokit
+    issuekit
+    leasekit
+    librarykit
+    maxkit
+    modelkit
+    ormkit
+    persistkit
+    servicekit
+    sessionkit
+    skillkit
+    socialkit
+    storagekit
+    telemetrykit
+    totp_client
+    worker_service

s_clientkit-0.1.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_clientkit-0.0.1 → s_clientkit-0.1.0}/AGENTS.md

@@ -1,45 +1,45 @@
-# AGENTS.md — clientkit
-
-> Контекст для AI-ассистентов (Claude Code, ChatGPT, Cursor и т.п.), работающих
-> над этим проектом.
-
-## Что это
-
-(заполнить one-line)
-
-## Atlas
-
-Проект зарегистрирован в Atlas-БД (Atlas). Карточка:
-
-```sh
-atlas project get clientkit
-```
-
-Любые изменения метаданных (приоритет, статус, теги) — через atlas CLI:
-
-- `atlas project update clientkit --priority P0` — поменять приоритет
-- `atlas project tag add clientkit -t domain:<slug>` — добавить тег
-- `atlas project move clientkit --to-type <type>` — конвертировать тип
-
-## Тип / Статус (на момент создания)
-
-- type=`kit`, status=`active`, priority=`P2`
-
-## Правила работы
-
-- Все исходные тексты, документы, код проекта — в этом репо.
-- Чувствительные данные (`.env`, токены, ключи) — игнорируются `.gitignore`.
-- AI-ассистенту разрешено: читать, генерировать, редактировать в этом репо.
-
-## Канонические команды
-
-- `atlas project get clientkit` — карточка проекта
-- `atlas task list --project clientkit` — задачи проекта (когда W7
-  волна будет реализована)
-
-<!-- atlas:usage:start -->
-## Управление проектом — через Atlas
-
-Этот проект ведётся в Atlas (личная PM-система портфеля). Для задач/проектов/эпиков/бэкапов
-используй CLI `atlas` и вызывай навык `atlas` — вся логика и роутинг внутри навыка.
-<!-- atlas:usage:end -->
+# AGENTS.md — clientkit
+
+> Контекст для AI-ассистентов (Claude Code, ChatGPT, Cursor и т.п.), работающих
+> над этим проектом.
+
+## Что это
+
+(заполнить one-line)
+
+## Atlas
+
+Проект зарегистрирован в Atlas-БД (Atlas). Карточка:
+
+```sh
+atlas project get clientkit
+```
+
+Любые изменения метаданных (приоритет, статус, теги) — через atlas CLI:
+
+- `atlas project update clientkit --priority P0` — поменять приоритет
+- `atlas project tag add clientkit -t domain:<slug>` — добавить тег
+- `atlas project move clientkit --to-type <type>` — конвертировать тип
+
+## Тип / Статус (на момент создания)
+
+- type=`kit`, status=`active`, priority=`P2`
+
+## Правила работы
+
+- Все исходные тексты, документы, код проекта — в этом репо.
+- Чувствительные данные (`.env`, токены, ключи) — игнорируются `.gitignore`.
+- AI-ассистенту разрешено: читать, генерировать, редактировать в этом репо.
+
+## Канонические команды
+
+- `atlas project get clientkit` — карточка проекта
+- `atlas task list --project clientkit` — задачи проекта (когда W7
+  волна будет реализована)
+
+<!-- atlas:usage:start -->
+## Управление проектом — через Atlas
+
+Этот проект ведётся в Atlas (личная PM-система портфеля). Для задач/проектов/эпиков/бэкапов
+используй CLI `atlas` и вызывай навык `atlas` — вся логика и роутинг внутри навыка.
+<!-- atlas:usage:end -->

{s_clientkit-0.0.1 → s_clientkit-0.1.0}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog — s-clientkit
 
+## [0.1.0] — 2026-09-06
+
+Волна китов-оснований: транспорт только через netkit, свой `TokenBucket` удалён.
+
+### Breaking
+- `s-netkit` теперь ОБЯЗАТЕЛЬНАЯ базовая зависимость (`>=0.1.1,<0.2`), extra
+  `net` убран — «поставил кит без netkit» больше не собирается вовсе.
+- `clientkit._limit.TokenBucket` удалён. Гейт лимита в
+  `ServiceClientBase` — теперь `netkit.limit.RateLimiter` (тот же смысл:
+  «не чаще `rate` в секунду при ёмкости `burst`», объявленный в `[limits]`
+  декларации сервиса).
+- `resolve_transport()` больше НЕ откатывается на голый `httpx.AsyncClient()`,
+  если под netkit что-то пошло не так, — молчаливая деградация с
+  `except Exception` заменена на `except ImportError`. Без netkit — отказ
+  `clientkit.errors.TransportUnavailable` с рецептом (`pip install s-netkit`
+  либо свой `transport=`), а не «тихо поехали на другом транспорте».
+
+### Changed
+- `clientkit.errors` — новый `TransportUnavailable` (та же доменная иерархия,
+  код `TRANSPORT_UNAVAILABLE`).
+
 ## 0.0.1 — кит-сборщик (задача #1423)
 
 Первый выпуск.

{s_clientkit-0.0.1 → s_clientkit-0.1.0}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.5
 Name: s-clientkit
-Version: 0.0.1
+Version: 0.1.0
 Summary: КИТ-СБОРЩИК: по ДЕКЛАРАЦИИ сервиса (TOML/dataclass) собирает готовый клиент из слоёв — белый API прямыми запросами, скрытый с удержанием доступа. Потребитель зовёт одинаково.
 Author: Dmitry
 License: MIT
 License-File: LICENSE
 Requires-Python: >=3.11
 Requires-Dist: s-corekit>=0.0.2
+Requires-Dist: s-netkit<0.2,>=0.1.1
 Provides-Extra: dev
 Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
@@ -14,11 +15,9 @@ Requires-Dist: ruff>=0.8; extra == 'dev'
 Provides-Extra: endpoints
 Requires-Dist: s-adapterkit>=0.1.8; extra == 'endpoints'
 Provides-Extra: hidden
-Requires-Dist: s-authkit-client>=0.0.2; extra == 'hidden'
+Requires-Dist: s-authkit-client<0.2,>=0.0.2; extra == 'hidden'
 Provides-Extra: http
 Requires-Dist: httpx>=0.27; extra == 'http'
-Provides-Extra: net
-Requires-Dist: s-netkit>=0.0.2; extra == 'net'
 Description-Content-Type: text/markdown
 
 # s-clientkit — кит-сборщик клиентов
@@ -72,7 +71,8 @@ await hidden.call("me")     # скрытый API с сессией и лестн
 ## Чего в ките нет
 
 * **своего HTTP** — «чем ходить» приходит аргументом (`RequestPort`), умолчание
-  (netkit → httpx) резолвится лениво;
+  (только netkit; без него — `TransportUnavailable` с рецептом установки) резолвится
+  лениво;
 * **своего браузера** — чеканка приходит через порт слоя доступа;
 * **своей таксономии отказов** — диагноз ставит `corekit.diagnosis.access`, та же
   функция, что у живой пробы и у реестра эндпоинтов.

{s_clientkit-0.0.1 → s_clientkit-0.1.0}/README.md

@@ -49,7 +49,8 @@ await hidden.call("me")     # скрытый API с сессией и лестн
 ## Чего в ките нет
 
 * **своего HTTP** — «чем ходить» приходит аргументом (`RequestPort`), умолчание
-  (netkit → httpx) резолвится лениво;
+  (только netkit; без него — `TransportUnavailable` с рецептом установки) резолвится
+  лениво;
 * **своего браузера** — чеканка приходит через порт слоя доступа;
 * **своей таксономии отказов** — диагноз ставит `corekit.diagnosis.access`, та же
   функция, что у живой пробы и у реестра эндпоинтов.