s-issuekit 0.2.0__tar.gz → 0.3.0__tar.gz

{s_issuekit-0.2.0 → s_issuekit-0.3.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_issuekit-0.3.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=S-kits, project=issuekit,
+#   top-level pipeline file=.gitlab-ci.yml, environment — пусто).
+# Дистрибутив на PyPI: s-issuekit.
+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_issuekit-0.3.0/.importlinter

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

s_issuekit-0.3.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_issuekit-0.2.0 → s_issuekit-0.3.0}/AGENTS.md

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

s_issuekit-0.3.0/CHANGELOG.md

@@ -0,0 +1,25 @@
+# CHANGELOG
+
+All notable changes to this project will be documented in this file.
+
+## [0.3.0] — 2026-09-08
+
+### Changed
+
+- **ЗАМОРОЖЕН.** Atlas #2710 (волна 5): единственный потребитель (`atlas`) убрал
+  зависимость `s-issuekit` из своего `pyproject.toml` и получил идентичную
+  копию кода как vendored-модуль `atlas._vendor.issuekit`. Код в этом
+  репозитории не изменился и не удалён — кит просто перестаёт активно
+  развиваться здесь до появления второго независимого потребителя. Версия
+  поднята на минор как маркер этой ломающей для «роли кита платформы» правки
+  (сам код и публичный API не менялись).
+
+## [0.2.0] — 2026-09-08
+
+### Added
+
+- MVP: шаблоны видов жалоб (bug / feature / handoff агент→агент) как данные
+- `lint` — машинная проверка качества жалобы (недостающие поля чеклиста + балл)
+- Навык-гайд «как зарепортить проблему, чтобы вас не возненавидели»
+- `submit` — отправка issue в GitHub/GitLab от `gh`/`glab` с блокирующей проверкой
+- Навык обогащён эталонами индустрии (Tatham/ESR/MRE/SSCCE/handoff)

{s_issuekit-0.2.0 → s_issuekit-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: s-issuekit
-Version: 0.2.0
+Version: 0.3.0
 Summary: Как правильно составить жалобу (issue/feature/handoff агент→агент): шаблоны-данные + валидатор качества (каких полей чеклиста не хватает) для богатой обратной связи. Тонкий слой на clikit.
 Author: Dmitry
 License: MIT
@@ -14,6 +14,16 @@ Description-Content-Type: text/markdown
 
 # issuekit
 
+> **⚠️ ЗАМОРОЖЕН (2026-09-08, Atlas #2710, волна 5).** Единственный потребитель —
+> `atlas` — больше не тянет этот пакет с PyPI: код физически перенесён в
+> `atlas._vendor.issuekit` (спека платформы, «по одному потребителю → модуль
+> Atlas»). Этот репозиторий и код в нём **не удалены** и остаются рабочими —
+> кит просто больше не развивается активно здесь. Если появится второй
+> независимый потребитель — код можно расформировать обратно в отдельный кит
+> (обе копии сейчас идентичны на момент заморозки). Новые правки самого
+> `issuekit` (не atlas) ведите осторожно: копия в atlas их не подхватит
+> автоматически.
+
 **Как правильно составить жалобу — и валидатор качества.** Переиспользуемый слой
 (dist `s-issuekit` / import `issuekit`) поверх `clikit`. Три вида жалоб как ДАННЫЕ:
 **bug** / **feature** / **handoff** (передача задачи агент→агент). Машинная проверка

{s_issuekit-0.2.0 → s_issuekit-0.3.0}/README.md

@@ -1,5 +1,15 @@
 # issuekit
 
+> **⚠️ ЗАМОРОЖЕН (2026-09-08, Atlas #2710, волна 5).** Единственный потребитель —
+> `atlas` — больше не тянет этот пакет с PyPI: код физически перенесён в
+> `atlas._vendor.issuekit` (спека платформы, «по одному потребителю → модуль
+> Atlas»). Этот репозиторий и код в нём **не удалены** и остаются рабочими —
+> кит просто больше не развивается активно здесь. Если появится второй
+> независимый потребитель — код можно расформировать обратно в отдельный кит
+> (обе копии сейчас идентичны на момент заморозки). Новые правки самого
+> `issuekit` (не atlas) ведите осторожно: копия в atlas их не подхватит
+> автоматически.
+
 **Как правильно составить жалобу — и валидатор качества.** Переиспользуемый слой
 (dist `s-issuekit` / import `issuekit`) поверх `clikit`. Три вида жалоб как ДАННЫЕ:
 **bug** / **feature** / **handoff** (передача задачи агент→агент). Машинная проверка

s_issuekit-0.3.0/docs/adr/0000-template.md

@@ -0,0 +1,20 @@
+# NNNN. Краткий заголовок решения
+
+- **Статус:** proposed | accepted | superseded (→ ADR-NNNN) | deprecated
+- **Дата:** ГГГГ-ММ-ДД
+
+## Контекст
+
+Какую ситуацию/проблему решаем. Что вынуждает принять решение сейчас: ограничения, требования, силы, которые тянут в разные стороны. Достаточно, чтобы понять «почему» без внешнего контекста.
+
+## Решение
+
+Что именно решили — одной-двумя фразами, в настоящем времени: «Делаем X». Конкретно и проверяемо.
+
+## Последствия
+
+Что становится проще и что — сложнее/дороже после принятия. Плюсы, минусы, новые обязательства и ограничения, которые теперь придётся держать.
+
+## Альтернативы
+
+Какие варианты рассматривали и **почему отклонили** (в этом ценность записи). Кратко: вариант → причина отказа / отложено до условия.

s_issuekit-0.3.0/docs/adr/README.md

@@ -0,0 +1,30 @@
+# ADR — журнал архитектурных решений
+
+**Что это.** ADR (Architecture Decision Record) — короткий документ на **одно** архитектурное решение: контекст → что решили → почему → последствия. Лежат здесь, в `docs/adr/`, со **сквозной нумерацией** (`0001-…`, `0002-…`). Шаблон — [`0000-template.md`](0000-template.md).
+
+**Зачем.** «Почему» проекта нельзя держать в комментариях к задачам и переписке — оно теряется. ADR — дистиллят решения: агент читает его **перед** правкой и не «чинит» то, что было выбрано сознательно. Дёшев по токенам: одно решение прочитать проще, чем реконструировать его из истории коммитов.
+
+## Когда заводить ADR — когда сошлись 3 условия
+
+1. решение **дорого откатить** (влияет на структуру, данные, контракты);
+2. без контекста оно **выглядит странно** (кто-то потом захочет «починить»);
+3. были **реальные альтернативы** и выбор — осознанный трейдофф.
+
+Если хотя бы одно условие не выполнено — ADR не нужен, хватит `comment` на задаче в Atlas.
+
+## Правила ведения
+
+- **Нумерация сквозная**, файл — `NNNN-краткий-слаг.md` (`0001-operating-model-foundamentals.md`).
+- **Не редактировать задним числом.** Принятое решение — исторический факт. Если решение отменено новым — старому ставим `Статус: superseded` (со ссылкой на новое ADR), а не переписываем его.
+- **«Схлопывание».** Когда цепочка `superseded` разрослась, допустимо свести её к одному ADR с текущим состоянием — ради экономии контекста агента. Прежние помечаем как схлопнутые.
+- **Статусы:** `proposed` → `accepted` → (`superseded` / `deprecated`).
+
+## Что НЕ идёт в ADR
+
+- **состояние** (ветка/worktree, стадия) — это тег/поле задачи в Atlas;
+- **ход работы / handoff** — `comment` на задаче в Atlas;
+- **черновой план реализации** — scratchpad, в `.gitignore`, в репо не коммитится.
+
+Полная модель фиксации артефактов (4 слоя) — в `ai-ecosystem-core/AGENT-OPERATING-MODEL.md`, раздел «Модель фиксации артефактов».
+
+**Методология:** практика ADR (Michael Nygard), компактный формат Matt Pocock (`github.com/mattpocock/skills`, grill-with-docs), примеры в NATS / AG2.

{s_issuekit-0.2.0 → s_issuekit-0.3.0}/issuekit/__init__.py

@@ -8,7 +8,9 @@
 """
 from __future__ import annotations
 
-__version__ = "0.2.0"
+from importlib.metadata import version as _version
+
+__version__ = _version("s-issuekit")  # имя дистрибутива — [project].name в pyproject.toml
 
 from .lint import LintResult, lint
 from .render import new_template, section_header

{s_issuekit-0.2.0 → s_issuekit-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "s-issuekit"
-version = "0.2.0"
+version = "0.3.0"
 description = "Как правильно составить жалобу (issue/feature/handoff агент→агент): шаблоны-данные + валидатор качества (каких полей чеклиста не хватает) для богатой обратной связи. Тонкий слой на clikit."
 readme = "README.md"
 requires-python = ">=3.11"