s-issuekit 0.1.0__tar.gz

s_issuekit-0.1.0/.gitignore

@@ -0,0 +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

s_issuekit-0.1.0/.gitlab-ci.yml

@@ -0,0 +1,31 @@
+# Автопубликация на PyPI по семвер-тегу vX.Y.Z через Trusted Publishing (OIDC).
+# Токены НИГДЕ не хранятся: 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 — пусто).
+# Запускается ТОЛЬКО на тег vX.Y.Z (обычный push на main ничего не публикует).
+stages: [publish]
+
+publish-pypi:
+  stage: publish
+  image: ghcr.io/astral-sh/uv:python3.12-bookworm
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+  id_tokens:
+    PYPI_ID_TOKEN:
+      aud: pypi
+  script:
+    - uv build
+    # обмен GitLab OIDC -> одноразовый PyPI API-токен (Trusted Publishing):
+    - |
+      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.1.0/AGENTS.md

@@ -0,0 +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 -->

s_issuekit-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_issuekit-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: s-issuekit
+Version: 0.1.0
+Summary: Как правильно составить жалобу (issue/feature/handoff агент→агент): шаблоны-данные + валидатор качества (каких полей чеклиста не хватает) для богатой обратной связи. Тонкий слой на clikit.
+Author: Dmitry
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: s-clikit
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# issuekit
+
+**Как правильно составить жалобу — и валидатор качества.** Переиспользуемый слой
+(dist `s-issuekit` / import `issuekit`) поверх `clikit`. Три вида жалоб как ДАННЫЕ:
+**bug** / **feature** / **handoff** (передача задачи агент→агент). Машинная проверка
+`lint` говорит, каких полей чеклиста не хватает — основа **богатой обратной связи**
+в мультиагентной работе.
+
+## Зачем
+
+Разница между жалобой, которую чинят за 5 минут, и той, что висит месяцами — не в
+сложности бага, а в оформлении. issuekit кодирует чеклист (версии / минимальный
+пример / traceback / ожидал-vs-получил / для фич — юзкейс) и проверяет его
+автоматически. В Atlas на этом строится блокирующая дисциплина передачи задач между
+агентами.
+
+## Установка
+
+```bash
+pip install s-issuekit        # import issuekit (dist-имя ≠ import-имя)
+```
+
+## CLI
+
+```bash
+issuekit kinds                          # виды + обязательные секции
+issuekit new --kind handoff --title "…" # пустой шаблон → заполнить
+issuekit lint myissue.md --kind bug     # проверка: чего не хватает + балл
+cat issue.md | issuekit lint -k feature
+```
+
+## Библиотека
+
+```python
+from issuekit import lint, new_template, list_kinds
+
+tpl = new_template("handoff", title="Доделать миграцию")
+res = lint(text, "handoff")     # res.ok (все required заполнены), res.score, res.missing
+if not res.ok:
+    print("не хватает:", res.missing)
+```
+
+## Виды и обязательные секции
+
+- **bug**: что сломалось · ожидал · получил · версии · минимальный пример · полный traceback.
+- **feature**: задача (юзкейс) · желаемый результат.
+- **handoff**: что сделано · что осталось · ожидаемый результат (ЦКП) · как проверить · контекст и версии.
+
+Расширить виды без правки кита — запись в `data/kinds.json` или entry-points `issuekit.kinds`.
+
+## Навык
+
+Несёт навык `skills/issuekit/SKILL.md` — «как зарепортить проблему, чтобы вас не
+возненавидели» (как правильно / антипаттерны).
+
+## Лицензия
+
+[MIT](LICENSE).

s_issuekit-0.1.0/README.md

@@ -0,0 +1,58 @@
+# issuekit
+
+**Как правильно составить жалобу — и валидатор качества.** Переиспользуемый слой
+(dist `s-issuekit` / import `issuekit`) поверх `clikit`. Три вида жалоб как ДАННЫЕ:
+**bug** / **feature** / **handoff** (передача задачи агент→агент). Машинная проверка
+`lint` говорит, каких полей чеклиста не хватает — основа **богатой обратной связи**
+в мультиагентной работе.
+
+## Зачем
+
+Разница между жалобой, которую чинят за 5 минут, и той, что висит месяцами — не в
+сложности бага, а в оформлении. issuekit кодирует чеклист (версии / минимальный
+пример / traceback / ожидал-vs-получил / для фич — юзкейс) и проверяет его
+автоматически. В Atlas на этом строится блокирующая дисциплина передачи задач между
+агентами.
+
+## Установка
+
+```bash
+pip install s-issuekit        # import issuekit (dist-имя ≠ import-имя)
+```
+
+## CLI
+
+```bash
+issuekit kinds                          # виды + обязательные секции
+issuekit new --kind handoff --title "…" # пустой шаблон → заполнить
+issuekit lint myissue.md --kind bug     # проверка: чего не хватает + балл
+cat issue.md | issuekit lint -k feature
+```
+
+## Библиотека
+
+```python
+from issuekit import lint, new_template, list_kinds
+
+tpl = new_template("handoff", title="Доделать миграцию")
+res = lint(text, "handoff")     # res.ok (все required заполнены), res.score, res.missing
+if not res.ok:
+    print("не хватает:", res.missing)
+```
+
+## Виды и обязательные секции
+
+- **bug**: что сломалось · ожидал · получил · версии · минимальный пример · полный traceback.
+- **feature**: задача (юзкейс) · желаемый результат.
+- **handoff**: что сделано · что осталось · ожидаемый результат (ЦКП) · как проверить · контекст и версии.
+
+Расширить виды без правки кита — запись в `data/kinds.json` или entry-points `issuekit.kinds`.
+
+## Навык
+
+Несёт навык `skills/issuekit/SKILL.md` — «как зарепортить проблему, чтобы вас не
+возненавидели» (как правильно / антипаттерны).
+
+## Лицензия
+
+[MIT](LICENSE).

s_issuekit-0.1.0/issuekit/__init__.py

@@ -0,0 +1,27 @@
+"""issuekit — как правильно составить жалобу (issue/feature/handoff) + валидатор.
+
+Кит даёт: (1) шаблоны видов жалоб (bug / feature / handoff агент→агент) как
+ДАННЫЕ; (2) ``lint`` — машинная проверка качества жалобы (каких полей чеклиста не
+хватает + балл); (3) навык-гайд «как зарепортить проблему, чтобы вас не
+возненавидели». Потребитель (Atlas) использует ``lint`` для блокирующей дисциплины
+передачи задач между агентами — богатая обратная связь гарантирована.
+"""
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+from .lint import LintResult, lint
+from .render import new_template, section_header
+from .spec import KindSpec, Section, get_kind, list_kinds
+
+__all__ = [
+    "__version__",
+    "lint",
+    "LintResult",
+    "new_template",
+    "section_header",
+    "get_kind",
+    "list_kinds",
+    "KindSpec",
+    "Section",
+]

s_issuekit-0.1.0/issuekit/cli.py

@@ -0,0 +1,89 @@
+"""CLI кита: ``issuekit new`` (шаблон) / ``issuekit lint`` (проверка) / ``kinds``."""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import typer
+from clikit import CliError, build_root_app, command, emit_data
+
+from . import __version__
+from .lint import lint as _lint
+from .render import new_template
+from .spec import get_kind, list_kinds
+
+app = build_root_app(
+    "issuekit",
+    version=__version__,
+    help="Как правильно составить жалобу (bug/feature/handoff) + валидатор (--json по умолчанию).",
+)
+
+
+@app.command("kinds")
+@command
+def kinds_cmd() -> None:
+    """Виды жалоб + их обязательные секции."""
+    data = [
+        {
+            "kind": k,
+            "label": get_kind(k).label,
+            "required": [s.label for s in get_kind(k).required_sections()],
+        }
+        for k in list_kinds()
+    ]
+    emit_data(data, text_renderer=lambda rows: [
+        print(f"{r['kind']:<10} {r['label']}  · обязательно: {', '.join(r['required'])}")
+        for r in rows
+    ])
+
+
+@app.command("new")
+@command
+def new_cmd(
+    kind: str = typer.Option("bug", "--kind", "-k", help="bug | feature | handoff."),
+    title: str | None = typer.Option(None, "--title", help="Заголовок жалобы."),
+) -> None:
+    """Вывести пустой шаблон жалобы (markdown) — заполни и отправляй."""
+    try:
+        text = new_template(kind, title=title)
+    except ValueError as exc:
+        raise CliError("bad_kind", str(exc)) from exc
+    # шаблон — это текст для человека: печатаем как есть (stdout).
+    print(text, end="")
+
+
+@app.command("lint")
+@command
+def lint_cmd(
+    file: str | None = typer.Argument(None, help="Файл жалобы (md); '-'/без аргумента — stdin."),
+    kind: str = typer.Option("bug", "--kind", "-k", help="bug | feature | handoff."),
+) -> None:
+    """Проверить жалобу: каких обязательных полей не хватает + балл."""
+    text = sys.stdin.read() if file in (None, "-") else Path(file).read_text(encoding="utf-8")
+    try:
+        res = _lint(text, kind)
+    except ValueError as exc:
+        raise CliError("bad_kind", str(exc)) from exc
+    data = {
+        "kind": res.kind, "ok": res.ok, "score": res.score,
+        "missing": res.missing, "present": res.present,
+        "empty_optional": res.empty_optional,
+    }
+
+    def _render(d: dict) -> None:
+        if d["ok"]:
+            print(f"✓ Полная жалоба ({d['kind']}, балл {d['score']}). Можно отправлять.")
+        else:
+            print(f"✗ Неполная жалоба ({d['kind']}, балл {d['score']}). Не хватает обязательного:")
+            for m in d["missing"]:
+                print(f"   — {m}")
+
+    emit_data(data, text_renderer=_render)
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

s_issuekit-0.1.0/issuekit/data/kinds.json

@@ -0,0 +1,42 @@
+{
+  "_schema": "issuekit.kinds/1 — виды жалоб как ДАННЫЕ: секции шаблона + какие обязательны. Валидатор (lint) проверяет наличие и непустоту required-секций; render строит пустой шаблон. Основано на чеклисте 'как зарепортить проблему, чтобы вас не возненавидели'.",
+  "kinds": {
+    "bug": {
+      "label": "Баг-репорт",
+      "title_hint": "<одно предложение: что сломалось>",
+      "sections": [
+        {"key": "summary", "label": "Что сломалось", "required": true, "hint": "одно предложение"},
+        {"key": "expected", "label": "Ожидал", "required": true, "hint": "X"},
+        {"key": "actual", "label": "Получил", "required": true, "hint": "Y"},
+        {"key": "versions", "label": "Версии", "required": true, "hint": "библиотека X.Y.Z · язык/рантайм · окружение/брокер · важные подзависимости"},
+        {"key": "repro", "label": "Минимальный пример", "required": true, "hint": "копипаст-runnable, 10-20 строк, БЕЗ домена/конфигов/лишних зависимостей"},
+        {"key": "traceback", "label": "Полный traceback", "required": true, "hint": "целиком, не скриншот и не последняя строчка"},
+        {"key": "steps", "label": "Шаги воспроизведения", "required": false, "hint": "1… 2… 3…"},
+        {"key": "tried", "label": "Что уже пробовал", "required": false, "hint": "чтобы не советовали отмёл­енное"}
+      ]
+    },
+    "feature": {
+      "label": "Фича-реквест",
+      "title_hint": "<задача, которую решаешь — НЕ решение>",
+      "sections": [
+        {"key": "usecase", "label": "Задача (юзкейс)", "required": true, "hint": "что и ЗАЧЕМ пытаюсь сделать (опиши задачу, а не решение)"},
+        {"key": "desired", "label": "Желаемый результат", "required": true, "hint": "что считаю успехом (НЕ конкретное API/решение)"},
+        {"key": "current", "label": "Сейчас", "required": false, "hint": "как обхожусь / почему не выходит"},
+        {"key": "context", "label": "Контекст", "required": false, "hint": "версии, ограничения"}
+      ]
+    },
+    "handoff": {
+      "label": "Передача задачи (агент → агент)",
+      "title_hint": "<что передаём и кому>",
+      "sections": [
+        {"key": "done", "label": "Что сделано", "required": true, "hint": "конкретно: какие файлы/изменения/коммиты"},
+        {"key": "remaining", "label": "Что осталось", "required": true, "hint": "чёткий список того, что доделать"},
+        {"key": "expected", "label": "Ожидаемый результат (ЦКП)", "required": true, "hint": "измеримый признак, что задача закрыта"},
+        {"key": "repro", "label": "Как проверить / воспроизвести", "required": true, "hint": "команды/шаги для запуска и проверки (копипаст)"},
+        {"key": "context", "label": "Контекст и версии", "required": true, "hint": "ветка/окружение/зависимости/где лежит код"},
+        {"key": "tried", "label": "Что уже пробовал / тупики", "required": false, "hint": "чтобы не повторять отмёл­енное"},
+        {"key": "blockers", "label": "Блокеры / риски", "required": false, "hint": "что мешает / на что обратить внимание"}
+      ]
+    }
+  }
+}

s_issuekit-0.1.0/issuekit/lint.py

@@ -0,0 +1,104 @@
+"""Валидатор жалобы: проверка наличия и непустоты обязательных секций.
+
+«Богатая обратная связь» машинно: ``lint(text, kind)`` говорит, каких полей
+чеклиста не хватает (versions/repro/traceback/expected/…), и считает балл. На
+этом строится блокирующая дисциплина передачи задач в Atlas (нельзя передать
+неполную жалобу — симметрично обязательному ЦКП у задачи).
+"""
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass, field
+
+from .render import SECTION_PREFIX
+from .spec import Section, get_kind
+
+#: HTML-комментарии (подсказки шаблона) — не считаются содержимым.
+_COMMENT_RE = re.compile(r"<!--.*?-->", re.DOTALL)
+#: Хвост-маркер опциональности в заголовке.
+_OPT_RE = re.compile(r"_\(опционально\)_", re.IGNORECASE)
+
+
+@dataclass(frozen=True)
+class LintResult:
+    """Итог проверки жалобы."""
+
+    kind: str
+    ok: bool                       # все обязательные секции заполнены
+    score: float                   # доля заполненных обязательных (0..1)
+    missing: list[str] = field(default_factory=list)   # labels незаполненных required
+    present: list[str] = field(default_factory=list)   # labels заполненных
+    empty_optional: list[str] = field(default_factory=list)
+
+
+def _split_sections(text: str) -> dict[str, str]:
+    """Разбить текст по ``## <label>`` на {нормализованный_label: содержимое}."""
+    out: dict[str, str] = {}
+    cur_label: str | None = None
+    buf: list[str] = []
+
+    def _flush() -> None:
+        if cur_label is not None:
+            out[cur_label] = "\n".join(buf)
+
+    for line in text.splitlines():
+        if line.startswith(SECTION_PREFIX):
+            _flush()
+            header = line[len(SECTION_PREFIX):]
+            header = _OPT_RE.sub("", header).strip().rstrip("#").strip()
+            cur_label = header.lower()
+            buf = []
+        elif cur_label is not None:
+            buf.append(line)
+    _flush()
+    return out
+
+
+def _is_filled(content: str) -> bool:
+    """Непусто ли содержимое секции (после вырезания подсказок-комментариев)."""
+    stripped = _COMMENT_RE.sub("", content)
+    # убрать пустые код-фенсы ``` ``` и whitespace
+    stripped = stripped.replace("```", "").strip()
+    return bool(stripped)
+
+
+def lint(text: str, kind: str) -> LintResult:
+    """Проверить текст жалобы вида ``kind``: какие обязательные секции пусты."""
+    spec = get_kind(kind)
+    sections = _split_sections(text or "")
+
+    def _find(s: Section) -> str | None:
+        key = s.label.lower()
+        if key in sections:
+            return sections[key]
+        # мягкое совпадение: заголовок содержит label
+        for hk, hv in sections.items():
+            if key in hk:
+                return hv
+        return None
+
+    missing: list[str] = []
+    present: list[str] = []
+    empty_optional: list[str] = []
+    req_total = 0
+    req_filled = 0
+    for s in spec.sections:
+        content = _find(s)
+        filled = content is not None and _is_filled(content)
+        if s.required:
+            req_total += 1
+            if filled:
+                req_filled += 1
+                present.append(s.label)
+            else:
+                missing.append(s.label)
+        elif not filled:
+            empty_optional.append(s.label)
+        elif filled:
+            present.append(s.label)
+
+    score = (req_filled / req_total) if req_total else 1.0
+    return LintResult(
+        kind=kind, ok=not missing, score=round(score, 3),
+        missing=missing, present=present, empty_optional=empty_optional,
+    )

s_issuekit-0.1.0/issuekit/render.py

@@ -0,0 +1,27 @@
+"""Рендер пустого шаблона жалобы по виду (bug/feature/handoff)."""
+from __future__ import annotations
+
+from .spec import get_kind
+
+#: Маркер секции — по нему же ``lint`` находит секции в тексте.
+SECTION_PREFIX = "## "
+
+
+def section_header(label: str) -> str:
+    """Заголовок секции (единый формат для render + lint)."""
+    return f"{SECTION_PREFIX}{label}"
+
+
+def new_template(kind: str, *, title: str | None = None) -> str:
+    """Пустой markdown-шаблон жалобы вида ``kind`` с подсказками в секциях."""
+    spec = get_kind(kind)
+    lines: list[str] = [
+        f"# [{spec.label}] {title or spec.title_hint}",
+        "",
+    ]
+    for s in spec.sections:
+        req = "" if s.required else "  _(опционально)_"
+        lines.append(section_header(s.label) + req)
+        lines.append(f"<!-- {s.hint} -->" if s.hint else "")
+        lines.append("")
+    return "\n".join(lines).rstrip() + "\n"

s_issuekit-0.1.0/issuekit/spec.py

@@ -0,0 +1,64 @@
+"""Виды жалоб как ДАННЫЕ (загружаются из ``data/kinds.json``).
+
+Добавить вид/секцию = правка JSON, без правки кода. ``kinds.json`` — единый
+language-neutral источник правды (его же сможет прочитать будущий CLI на другом
+языке).
+"""
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass
+from functools import lru_cache
+from importlib import resources
+
+
+@dataclass(frozen=True)
+class Section:
+    """Секция шаблона жалобы."""
+
+    key: str
+    label: str
+    required: bool
+    hint: str = ""
+
+
+@dataclass(frozen=True)
+class KindSpec:
+    """Вид жалобы: bug | feature | handoff — набор секций."""
+
+    key: str
+    label: str
+    title_hint: str
+    sections: tuple[Section, ...]
+
+    def required_sections(self) -> tuple[Section, ...]:
+        return tuple(s for s in self.sections if s.required)
+
+
+@lru_cache(maxsize=1)
+def _registry() -> dict[str, KindSpec]:
+    raw = resources.files("issuekit").joinpath("data", "kinds.json").read_text("utf-8")
+    data = json.loads(raw)
+    out: dict[str, KindSpec] = {}
+    for key, d in data["kinds"].items():
+        sections = tuple(
+            Section(s["key"], s["label"], bool(s.get("required", False)), s.get("hint", ""))
+            for s in d["sections"]
+        )
+        out[key] = KindSpec(key, d.get("label", key), d.get("title_hint", ""), sections)
+    return out
+
+
+def list_kinds() -> list[str]:
+    """Доступные виды жалоб (ключи)."""
+    return list(_registry().keys())
+
+
+def get_kind(kind: str) -> KindSpec:
+    """KindSpec по ключу. Неизвестный → ValueError со списком доступных."""
+    reg = _registry()
+    if kind not in reg:
+        raise ValueError(
+            f"Неизвестный вид '{kind}'. Доступно: {', '.join(reg)}."
+        )
+    return reg[kind]