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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s-issuekit
-Version: 0.1.0
+Version: 0.2.0
 Summary: Как правильно составить жалобу (issue/feature/handoff агент→агент): шаблоны-данные + валидатор качества (каких полей чеклиста не хватает) для богатой обратной связи. Тонкий слой на clikit.
 Author: Dmitry
 License: MIT

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

@@ -8,11 +8,12 @@
 """
 from __future__ import annotations
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 
 from .lint import LintResult, lint
 from .render import new_template, section_header
 from .spec import KindSpec, Section, get_kind, list_kinds
+from .submit import PROVIDERS, SubmitError, extract_title, submit_issue
 
 __all__ = [
     "__version__",
@@ -24,4 +25,9 @@ __all__ = [
     "list_kinds",
     "KindSpec",
     "Section",
+    # отправка issue в GitHub/GitLab
+    "submit_issue",
+    "extract_title",
+    "SubmitError",
+    "PROVIDERS",
 ]

{s_issuekit-0.1.0 → s_issuekit-0.2.0}/issuekit/cli.py

@@ -81,6 +81,45 @@ def lint_cmd(
     emit_data(data, text_renderer=_render)
 
 
+@app.command("submit")
+@command
+def submit_cmd(
+    repo: str = typer.Option(..., "--repo", help="owner/repo (GH) или group/project (GL)."),
+    provider: str = typer.Option(..., "--provider", "-p", help="github | gitlab."),
+    kind: str = typer.Option("bug", "--kind", "-k", help="bug | feature | handoff."),
+    title: str | None = typer.Option(None, "--title", help="Заголовок (иначе из '# …' тела)."),
+    body_file: str | None = typer.Option(None, "--body-file", help="Файл тела (md); иначе stdin."),
+    label: list[str] = typer.Option(None, "--label", "-l", help="Метка (можно несколько)."),
+    force: bool = typer.Option(False, "--force", help="Отправить даже неполную (по умолч. блок)."),
+) -> None:
+    """Отправить жалобу как issue в GitHub/GitLab (от залогиненного gh/glab).
+
+    Перед отправкой ПРОВЕРЯЕТ полноту через lint — неполную не пускает (--force
+    обходит). Заголовок берётся из первой `# …` строки тела, если не задан."""
+    from .submit import SubmitError, extract_title, submit_issue
+
+    src = body_file
+    body = sys.stdin.read() if src in (None, "-") else Path(src).read_text(encoding="utf-8")
+    try:
+        res = _lint(body, kind)
+    except ValueError as exc:
+        raise CliError("bad_kind", str(exc)) from exc
+    if not res.ok and not force:
+        raise CliError(
+            "incomplete",
+            f"Жалоба неполная (балл {res.score}). Не хватает: {', '.join(res.missing)}. "
+            f"Добей секции или --force.",
+        )
+    final_title = title or extract_title(body) or "(no title)"
+    try:
+        out = submit_issue(provider, repo, final_title, body, labels=label or None)
+    except SubmitError as exc:
+        raise CliError("submit_failed", str(exc)) from exc
+    emit_data(out, text_renderer=lambda d: print(
+        f"✓ Issue создан ({d['provider']} {d['repo']}): {d['url']}"
+    ))
+
+
 def main() -> None:
     app()
 

s_issuekit-0.2.0/issuekit/submit.py

@@ -0,0 +1,79 @@
+"""Отправка жалобы как issue в GitHub/GitLab от залогиненного профиля (gh/glab).
+
+Provider-agnostic тонкий слой над CLI хостинга: ``gh issue create`` (GitHub) /
+``glab issue create`` (GitLab). Авторизация — у самого gh/glab (их логин/токен),
+issuekit ничего не хранит. Перед отправкой потребитель валидирует тело через
+``issuekit.lint`` (блокирующая дисциплина — неполную жалобу не шлём).
+"""
+from __future__ import annotations
+
+import re
+import subprocess
+
+#: Поддерживаемые хостинги (совпадает с CLI gh/glab).
+PROVIDERS = frozenset({"github", "gitlab"})
+
+
+class SubmitError(RuntimeError):
+    """Ошибка отправки issue (caller → CliError/Exit)."""
+
+
+def run(cmd: list[str]) -> tuple[int, str, str]:
+    """subprocess без shell; вернуть (rc, stdout, stderr). Не raise на rc!=0."""
+    p = subprocess.run(list(cmd), text=True, capture_output=True, check=False)
+    return p.returncode, p.stdout or "", p.stderr or ""
+
+
+def extract_title(body: str) -> str | None:
+    """Заголовок из первой строки ``# …`` тела (срезая префикс ``[Вид]``)."""
+    for line in body.splitlines():
+        s = line.strip()
+        if s.startswith("# "):
+            t = s[2:].strip()
+            t = re.sub(r"^\[[^\]]*\]\s*", "", t)  # срезать "[Баг] " и т.п.
+            return t or None
+    return None
+
+
+def _extract_url(text: str) -> str | None:
+    for tok in text.replace("\n", " ").split():
+        if tok.startswith("http://") or tok.startswith("https://"):
+            return tok.rstrip(".,;:")
+    return None
+
+
+def submit_issue(
+    provider: str,
+    repo: str,
+    title: str,
+    body: str,
+    *,
+    labels: list[str] | None = None,
+) -> dict[str, str]:
+    """Создать issue в ``repo`` через gh/glab. Вернуть ``{url, provider, repo}``.
+
+    GitHub: ``gh issue create --repo <repo> --title <t> --body <b> [--label …]``.
+    GitLab: ``glab issue create --repo <repo> --title <t> --description <b> [--label l1,l2]``.
+    """
+    p = (provider or "").lower()
+    if p not in PROVIDERS:
+        raise SubmitError(f"provider '{provider}': github | gitlab.")
+
+    if p == "github":
+        cmd = ["gh", "issue", "create", "--repo", repo, "--title", title, "--body", body]
+        for lbl in labels or []:
+            cmd += ["--label", lbl]
+    else:  # gitlab
+        cmd = ["glab", "issue", "create", "--repo", repo, "--title", title,
+               "--description", body, "--yes"]
+        if labels:
+            cmd += ["--label", ",".join(labels)]
+
+    rc, out, err = run(cmd)
+    if rc != 0:
+        tool = "gh" if p == "github" else "glab"
+        raise SubmitError(
+            f"{tool} issue create failed (rc={rc}): {err.strip() or out.strip()}. "
+            f"Залогинен? ({tool} auth status)"
+        )
+    return {"url": _extract_url(out) or out.strip(), "provider": p, "repo": repo}

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "s-issuekit"
-version = "0.1.0"
+version = "0.2.0"
 description = "Как правильно составить жалобу (issue/feature/handoff агент→агент): шаблоны-данные + валидатор качества (каких полей чеклиста не хватает) для богатой обратной связи. Тонкий слой на clikit."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -47,6 +47,10 @@ src = ["."]
 select = ["E", "F", "I", "B", "UP", "N", "SIM", "RUF"]
 ignore = ["RUF001", "RUF002", "RUF003", "RUF022"]
 
+[tool.ruff.lint.flake8-bugbear]
+# typer-паттерн: значения по умолчанию через typer.Option/Argument — это норма (не B008).
+extend-immutable-calls = ["typer.Option", "typer.Argument"]
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 pythonpath = ["."]

{s_issuekit-0.1.0 → s_issuekit-0.2.0}/skills/issuekit/SKILL.md

@@ -52,6 +52,9 @@ Respond in the user's language.
 issuekit new --kind bug --title "..."     # пустой шаблон → заполнить
 issuekit lint myissue.md --kind bug       # проверка: каких полей не хватает + балл
 cat myissue.md | issuekit lint --kind handoff
+# отправить в репо от залогиненного gh/glab (проверка полноты БЛОКИРУЕТ неполную):
+issuekit submit --repo owner/repo --provider github --kind bug --body-file myissue.md
+issuekit submit --repo group/proj --provider gitlab -k feature --body-file feat.md -l enhancement
 ```
 
 ```python
@@ -71,6 +74,16 @@ res = lint(text, "handoff")               # res.ok / res.score / res.missing
 - **handoff**: Что сделано · Что осталось · Ожидаемый результат (ЦКП) · Как
   проверить · Контекст и версии · (Что пробовал · Блокеры).
 
+## Глубже — эталоны индустрии
+
+Расширенный гайд с первоисточниками и идеальными примерами —
+[references/writing-good-issues.md](references/writing-good-issues.md): дисциплина
+коммуникации (Tatham, ESR, Bugzilla: симптом-не-диагноз, регрессия «а раньше
+работало?», точные пути действия, анти-XY, нейтральный тон); заголовок и поиск
+дублей; стандарт **MRE/SSCCE** (minimal/complete/reproducible/readable, данные
+инлайн); feature — проблема прежде решения; и **handoff агент→агент** (минимальный
+record, synthesis-readback перед approve, audit-метадата).
+
 ## Rules
 
 - **Приложи КОД** (минимальный, копипаст-runnable). Без него первый ответ — «приложите код».

s_issuekit-0.2.0/skills/issuekit/references/writing-good-issues.md

@@ -0,0 +1,118 @@
+# Как писать хорошие жалобы — расширенный гайд (эталоны индустрии)
+
+> Дополнение к навыку issuekit (SKILL.md). Веб-рисёрч: Tatham, ESR, Bugzilla, MRE/SSCCE, GitHub/GitLab, handoff-практики.
+
+## Дисциплина коммуникации (классические гайды)
+
+Сверх базового чеклиста — слой «эпистемики», который дёшев автору и режет раунды уточнений. Источники: [Tatham «How to Report Bugs Effectively»](https://www.chiark.greenend.org.uk/~sgtatham/bugs.html), [ESR «How To Ask Questions The Smart Way»](http://www.catb.org/~esr/faqs/smart-questions.html), [Mozilla/Bugzilla «Bug writing guidelines»](https://bugzilla.mozilla.org/page.cgi?id=bug-writing.html).
+
+- **Симптом, а не диагноз.** Описывай, что наблюдал, а не свою теорию причины. Диагноз — необязательный бонус, **не** замена симптому: если угадал — сэкономишь время, если ошибся и скрыл симптом — починят не то. Плохо: «баг в кодировке UTF-8». Хорошо: «в имени файла вместо `é` показывается `é` (возможно, про UTF-8)».
+- **Факты отдельно от догадок** — и догадки помечай явно. Чужая непроверенная теория уводит в ложном направлении.
+- **Никогда «не работает» / «сломалось».** Это пустая фраза: не запустилось? упало? выдало не то? зависло? — каждый вариант своя гипотеза. Пиши, что именно произошло и чего ты ждал.
+- **Регрессия: «а раньше работало?»** Укажи последнюю рабочую версию / диапазон («на 2.3.1 работало, на 2.4.0 сломалось»). Это локализует баг до конкретного изменения.
+- **Точность путей действия.** «Выбрал Load» = клик мышью? Alt+L? Enter на пункте? — баг может быть только в одном пути. Избегай местоимений: не «закрыл его, и оно упало», а «закрыл окно предупреждения, и упало приложение FooApp».
+- **Не чини вслепую до репорта.** При сбое сразу остановись, ничего не нажимай, зафиксируй точный текст ошибки и состояние. Перезапуск/переустановка затирают улики. Записывай номер ошибки, даже если кажется бессмысленным.
+- **Опиши ЦЕЛЬ, а не только застрявший шаг** (анти-XY-problem). Плохо: «как заставить regex съесть этот тег?». Хорошо: «нужно вытащить ссылки из HTML (цель); пробую regex (шаг) — застрял тут».
+- **Плавающий (intermittent) баг — не повод молчать.** Опиши частоту и условия: «падает ~1 раз из 10, только когда параллельно открыт экспорт и >8 вкладок». Явно скажи: воспроизводится всегда / иногда / не смог.
+- **Нейтральный тон без обвинений, сарказма и «срочно!!!».** Работаешь с тем же человеком, что и чинит; приписанная срочность раздражает и часто даёт обратный эффект.
+- **Решение постфактум.** Когда баг закрыт/обойдён — допиши, что помогло: «чинилось обновлением драйвера до 535.x; на 525.x воспроизводилось стабильно». Это превращает тикет в knowledge base.
+
+## Заголовок и поиск дублей
+
+- **Сначала ищи дубль, потом заводи.** «If the answer is one search away — don't post it». В тексте дай ссылку на похожие issue — это доказывает, что искал, и что задача не дубль. Дубликаты — главная причина отклонения.
+- **Заголовок = «объект — отклонение», конкретно и находимо.** Формат `[Компонент]: [что не так]`. Без декоративных слов («ENHANCEMENT», «REQUEST», «срочно», «баг???»). Плохо: «Too Hard to Scroll on WINDOWS RStudio Desktop 1.1.442…». Хорошо: «Increase scrollbar width on Windows». Summary ~10 слов, описывающих **проблему**, а не решение.
+- **Один баг — один issue.** Склейка нескольких проблем («крэши и тормоза») блокирует закрытие (часть пофикшена, часть нет) и ломает поиск дублей — заводи отдельный тикет на каждую.
+- **Грамотный, вычитанный текст** + корректные теги/проект: небрежность читается как небрежное мышление и снижает доверие; правильные теги = находимость.
+
+Источники: [Bugzilla](https://bugzilla.mozilla.org/page.cgi?id=bug-writing.html), [ESR](http://www.catb.org/~esr/faqs/smart-questions.html), [RStudio «Writing Good Feature Requests»](https://github.com/rstudio/rstudio/wiki/Writing-Good-Feature-Requests), [SO «How to ask»](https://stackoverflow.com/help/how-to-ask).
+
+## Стандарт MRE/SSCCE (минимальный воспроизводимый пример)
+
+Один стандарт под разными именами — **MRE / MWE / MCVE / SSCCE / reprex**. Это контракт: «скопировал → вставил → запустил → увидел ту же ошибку». Четыре свойства:
+
+- **Minimal** — каждая оставшаяся строка необходима для воспроизведения. Строй **не вырезанием из проекта, а с пустого файла**: добавляй минимум, пока баг не воспроизведётся (само сужение часто и находит причину). Если удаление куска ломает воспроизведение — он связан, верни. Пороги SSCCE: читатели бросают на ~100 строках, возмущаются на 250–300.
+- **Complete** — запускается из чистой сессии одним copy-paste. Включи **каждую** обязательную команду: все импорты, создание всех объектов, для SQL — DDL (`CREATE TABLE`) + `INSERT`. Ничего «из остального проекта».
+- **Reproducible** — реально запусти свежую копию перед отправкой. Любую случайность фиксируй: `set.seed()` / `random.seed()` / фиксированные даты вместо `now()`. Приведи **точный** текст ошибки (copy-paste, не пересказ) + строку, которая её порождает.
+- **Readable** — не жертвуй ясностью ради краткости: короткие осмысленные имена, единый стиль. Не маскируй встроенные функции (`mean`, `list`, `sum` как имена переменных).
+
+**Данные — инлайн, не файлом:** `pd.DataFrame({'a':[1,2]})`, `read.csv(text="...")`, `tribble()`; `dput()` — крайняя мера. У помогающего нет твоего CSV/БД.
+
+Дополнительные анти-паттерны MRE:
+- Не разрушай чужое окружение: никаких `rm(list=ls())`, `setwd('C:/...')`, `install.packages()` в теле примера. Создал файл — удали за собой.
+- Код как **текст**, не скриншот (скриншот не копируется и не ищется), и не «только ссылка» на внешний sandbox без самодостаточного кода в самом issue.
+
+Источники: [SO «Minimal Reproducible Example»](https://stackoverflow.com/help/minimal-reproducible-example), [SSCCE.org](https://sscce.org/), [reprex do's and don'ts](https://reprex.tidyverse.org/articles/reprex-dos-and-donts.html), [Wikipedia MRE](https://en.wikipedia.org/wiki/Minimal_reproducible_example).
+
+## Feature-реквест: проблема прежде решения
+
+- **Описывай ПРОБЛЕМУ, а не сразу решение.** «Most feature requests only describe solutions». Решение — лишь одна гипотеза; готовое решение лишает команду лучших альтернатив. Плохо: «сделайте скролл быстрее с Ctrl». Хорошо: «трачу слишком много времени, листая файл на 1000 строк, чтобы править оба конца». Шаблон: «Когда… → происходит… → это проблема, потому что…».
+- **Конкретный use case и реальный контекст:** кто, в каком рабочем сценарии, зачем. Вместо «добавьте бип на букву Q» — «работаю с пакетом, который шлёт Q-сигналы, и хожу по офису, поэтому нужно слышимое уведомление».
+- **Рассмотренные альтернативы + подводные камни.** «Be open to other solutions», назови потенциальные «rabbit holes». Приложи ссылки на аналоги в других продуктах, примеры кода, мокапы.
+- **Definition of Done / acceptance criteria** опциональной секцией — критерий приёмки фичи.
+
+Источники: [RStudio wiki](https://github.com/rstudio/rstudio/wiki/Writing-Good-Feature-Requests), [Mann Howie «Feature request template»](https://mannhowie.com/feature-request-template), [Atlassian «Feature request»](https://www.atlassian.com/agile/product-management/feature-request).
+
+## Эталонные примеры
+
+**Идеальный bug:**
+```
+Заголовок: Export → PDF: окно закрывается без файла и без ошибки (regression в 2.4.0)
+
+Версии: AppFoo 2.4.0, Windows 11 26200, рендерер Chromium 120. На 2.3.1 работало.
+
+Шаги (точно):
+1. Открыть документ doc.txt (приложен, 3 строки).
+2. Меню File → Export, кликнуть мышью пункт "PDF" (не Enter).
+3. В диалоге выбрать Desktop, нажать Save.
+
+Ожидал: на Desktop появится doc.pdf.
+Получил: окно экспорта закрывается, файла нет, ошибки нет.
+Лог (copy-paste, целиком):
+  [12:01:03] export.start fmt=pdf
+  [12:01:03] ERROR renderer: ENOENT spawn wkhtmltopdf
+Частота: 100% на этой машине. На 2.3.1 экспорт того же файла проходит.
+```
+Почему хорош: симптом (не диагноз), точный путь действия, ожидал-vs-получил, регрессия с рабочей версией, полный лог copy-paste, инлайн-вложение, частота.
+
+**Идеальный feature:**
+```
+Заголовок: Bulk-экспорт: выгрузить несколько документов одним действием
+
+Проблема: Когда нужно выгрузить отчёт из 40 файлов, экспортирую каждый
+вручную по одному (~15 мин). Это проблема, потому что на еженедельной
+рассылке это часовая рутина и я пропускаю файлы.
+
+Use case: аналитик, конец недели, готовит пакет отчётов клиенту;
+40–60 файлов, повторяется каждую пятницу.
+
+Предлагаемое решение (одна гипотеза): мультивыбор в списке + "Export selected".
+Альтернативы, что рассматривал: CLI-скрипт (нет у не-тех пользователей);
+"export all" по папке (не подходит — нужна выборка).
+Rabbit holes: прогресс/отмена для долгой пачки; коллизии имён файлов.
+Аналоги: так сделано в Bar 3.x (ссылка), мокап приложен.
+DoD: можно выбрать N документов и получить N файлов одним действием;
+ошибка по одному файлу не валит всю пачку.
+```
+Почему хорош: проблема прежде решения (с негативным эффектом и частотой), конкретный use case, альтернативы + честные rabbit holes, аналог/мокап, измеримый DoD.
+
+## Handoff-вид (агент → агент)
+
+Handoff — **не** дамп истории диалога и **не** односложное «сделал», а типизированная карточка передачи + обязательный read-back принимающего. Так сходятся 4 независимых домена: агентные multi-agent системы, software DoD, healthcare [I-PASS](https://www.americandatanetwork.com/patient-safety/patient-handoff-template-safety-transitions/)/[SBAR](https://www.ahrq.gov/teamstepps-program/curriculum/communication/tools/sbar.html), project handover.
+
+**Фиксированная схема handoff-record** (пустое поле = handoff не сдан; свободный `submit -m "сделал"` как единственная форма запрещён):
+
+- **cpp_dod** — однострочный ЦКП (результат, не активность) + чек-лист Definition of Done (tests/review/docs/validation). Reviewer ставит approve **только** при выполненном DoD.
+- **artifacts** — ссылки на коммиты/PR/файлы/тест-раны/диффы (queryable), **не** их пересказ. История диалога не копируется — принимающий добирает детали по ссылкам инструментами.
+- **decisions** — ключевые выборы с обоснованием («взял A, потому что B») + **что пробовал и НЕ сработало** (тупиковые попытки, чтобы следующий не повторял).
+- **not_done** — явный список незавершённого со статусом и причиной каждого пункта (blocked / out-of-scope / deferred). Открытые вопросы — явно, не между строк.
+- **contingencies** — реакции если-X-то-Y на известные риски («если упадёт тест T — смотри fixture F»; «если migrate падает — откатить ревизию R»). Убирает раунд переспросов при первом сбое.
+- **severity/confidence** — короткий сигнал срочности (блокер / в-работе / стабильно) + уверенность исполнителя («uncertain: edge-case Z не покрыт тестом»). Позволяет ревьюеру калибровать строгость; его отсутствие — anti-pattern plausible-incorrectness.
+- **next_step** — конкретный следующий шаг для принимающего.
+
+**Принципы передачи:**
+- **Решения + артефакты + ссылки, а не диалог.** Lossy-саммари стирают цепочку рассуждений → принимающий перепроверяет или галлюцинирует; everything-dump топит сигнал в шуме (lost-in-the-middle). Ссылки сохраняют traceable logic без перегруза.
+- **Минимум контекста по умолчанию.** В record — только метадата передачи (reason/priority/summary/next_step); крупное состояние по ссылке, принимающий запрашивает нужное сам.
+- **Synthesis-readback перед approve.** Прежде чем взять/одобрить, принимающий **обязан** вернуть короткий read-back («понял так: цель X, сделано Y, продолжаю с Z»). Approve без synthesis блокируется — это единственная точка, где расхождения ловятся до продолжения работы (и где гасится галлюцинация, что принимающий сам совершил предыдущие действия).
+- **Audit-метадата.** record несёт actor (кто сдал), reviewer (кому), timestamp, ссылку на состояние (task ref / lease). Передача — событие в журнале, не разовый текст; снятие lease исполнителя фиксируется.
+
+Источники: [XTrace «AI Agent Context Handoff»](https://xtrace.ai/blog/ai-agent-context-handoff), [Augment Code «Agent Handoff Patterns»](https://www.augmentcode.com/guides/agent-handoff-patterns-human-agent-interface), [OpenAI Agents SDK «Handoffs»](https://openai.github.io/openai-agents-python/handoffs/), [I-PASS](https://www.americandatanetwork.com/patient-safety/patient-handoff-template-safety-transitions/), [Atlassian DoD](https://www.atlassian.com/agile/project-management/definition-of-done), [NimbleWork «Task Handoffs»](https://www.nimblework.com/blog/task-handoffs-in-project-management/).

s_issuekit-0.2.0/tests/test_submit.py

@@ -0,0 +1,117 @@
+"""Отправка issue в GitHub/GitLab (submit) — ВСЕ subprocess мокаются."""
+from __future__ import annotations
+
+import json
+
+import pytest
+from typer.testing import CliRunner
+
+from issuekit import extract_title, submit_issue
+from issuekit.submit import SubmitError
+
+runner = CliRunner()
+
+
+def _app():
+    from issuekit.cli import app
+    return app
+
+
+_FULL = """\
+# [Баг] падает старт
+## Что сломалось
+crash
+## Ожидал
+ok
+## Получил
+no
+## Версии
+lib 1.0 · py 3.11
+## Минимальный пример
+```py
+import x
+```
+## Полный traceback
+```
+Traceback ...
+```
+"""
+
+
+# --- title extraction ---
+
+def test_extract_title_strips_kind_prefix():
+    assert extract_title("# [Баг] падает логин\n## …") == "падает логин"
+    assert extract_title("no header") is None
+
+
+# --- submit_issue (provider abstraction) ---
+
+def test_submit_github_invokes_gh(monkeypatch):
+    calls = []
+
+    def _fake(cmd):
+        calls.append(cmd)
+        return 0, "https://github.com/o/r/issues/1\n", ""
+
+    monkeypatch.setattr("issuekit.submit.run", _fake)
+    res = submit_issue("github", "o/r", "T", "body", labels=["bug"])
+    assert res["url"] == "https://github.com/o/r/issues/1"
+    cmd = calls[0]
+    assert cmd[:3] == ["gh", "issue", "create"] and "--repo" in cmd and "o/r" in cmd
+    assert "--label" in cmd and "bug" in cmd
+
+
+def test_submit_gitlab_invokes_glab(monkeypatch):
+    calls = []
+
+    def _fake(cmd):
+        calls.append(cmd)
+        return 0, "https://gitlab.com/g/p/-/issues/2\n", ""
+
+    monkeypatch.setattr("issuekit.submit.run", _fake)
+    res = submit_issue("gitlab", "g/p", "T", "body")
+    assert res["url"].endswith("/issues/2")
+    assert calls[0][:3] == ["glab", "issue", "create"] and "--description" in calls[0]
+
+
+def test_submit_unknown_provider():
+    with pytest.raises(SubmitError, match="github"):
+        submit_issue("bitbucket", "o/r", "T", "b")
+
+
+def test_submit_propagates_tool_failure(monkeypatch):
+    monkeypatch.setattr("issuekit.submit.run", lambda cmd: (1, "", "HTTP 404 / not logged in"))
+    with pytest.raises(SubmitError, match="failed"):
+        submit_issue("github", "o/r", "T", "b")
+
+
+# --- CLI submit (lint-gate) ---
+
+def test_cli_submit_blocks_incomplete(tmp_path):
+    f = tmp_path / "i.md"
+    f.write_text("# [Баг] x\n## Что сломалось\nпадает", encoding="utf-8")  # неполная
+    r = runner.invoke(_app(), ["submit", "--repo", "o/r", "--provider", "github",
+                               "--body-file", str(f), "--kind", "bug"])
+    assert r.exit_code != 0  # неполная → блок (gh НЕ зовётся)
+
+
+def test_cli_submit_full_calls_provider(tmp_path, monkeypatch):
+    monkeypatch.setattr("issuekit.submit.run",
+                        lambda cmd: (0, "https://github.com/o/r/issues/3\n", ""))
+    f = tmp_path / "i.md"
+    f.write_text(_FULL, encoding="utf-8")
+    r = runner.invoke(_app(), ["--json", "submit", "--repo", "o/r", "--provider", "github",
+                               "--body-file", str(f), "--kind", "bug"])
+    assert r.exit_code == 0, r.stdout
+    assert json.loads(r.stdout)["url"].endswith("/issues/3")
+
+
+def test_cli_submit_force_bypasses_lint(tmp_path, monkeypatch):
+    monkeypatch.setattr("issuekit.submit.run",
+                        lambda cmd: (0, "https://github.com/o/r/issues/4\n", ""))
+    f = tmp_path / "i.md"
+    f.write_text("# [Баг] x\n## Что сломалось\nпадает", encoding="utf-8")  # неполная
+    r = runner.invoke(_app(), ["submit", "--repo", "o/r", "--provider", "github",
+                               "--body-file", str(f), "--kind", "bug", "--force"])
+    assert r.exit_code == 0, r.stdout

{s_issuekit-0.1.0 → s_issuekit-0.2.0}/uv.lock

@@ -646,7 +646,7 @@ dependencies = [
 
 [[package]]
 name = "s-issuekit"
-version = "0.1.0"
+version = "0.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "s-clikit" },