# Хранилище задач: Gitea

Задачи и спецификации этого репозитория хранятся в Gitea Issues на
`git.dementev.space` (репозиторий `ddmitry/dotfiles`). Все операции — через
CLI `tea`. Внутри клона `tea` сам находит репозиторий и учётную запись по
`git remote`; если не нашёл, добавь `--repo ddmitry/dotfiles`.

GitVerse — только зеркало, задачи там не ведём.

Заголовки, описания и комментарии задач пишутся по-русски.

## Команды

- **Создать задачу**: `tea issues create --title "..." --description-file -`
  с текстом через heredoc. Метки — `--labels "a,b"`.
- **Прочитать задачу**: `tea issues <номер> --comments`.
- **Список задач**: `tea issues list --state open --labels "..." --fields
  index,title,labels,assignees --output json`.
- **Комментарий**: `tea comment <номер> "..."`.
- **Метки**: `tea issues edit <номер> --add-labels "..."` /
  `--remove-labels "..."`. Если метки ещё нет в репозитории, создай её:
  `tea labels create --name "..." --color "#..."`.
- **Закрыть**: сначала комментарий с причиной, затем `tea issues close <номер>`.

## PR как источник задач

**PR как источник запросов: нет.** _(Поставь `да`, если внешние PR в этом
репозитории нужно разбирать как запросы на доработку; `/triage` читает этот
флаг.)_

У задач и PR в Gitea общая нумерация: голый `#42` может оказаться и тем, и
другим. Проверяй через `tea issues 42` или `tea pulls 42`.

## Публикация задачи

Когда навык просит опубликовать задачу, нужно создать задачу в Gitea.

## Получение задачи

Нужно выполнить `tea issues <номер> --comments`.

## Работа `/wayfinder`

Карта — одна задача, дочерние задачи — отдельные задачи Gitea.

- **Карта**: задача с меткой `wayfinder:map`; в описании — разделы
  «Заметки», «Принятые решения» и «Неясности».
- **Дочерняя задача**: первой строкой описания — `Часть #<карта>`; в
  описании карты — список дочерних задач. Метка типа: `wayfinder:<тип>`
  (`research`, `prototype`, `grilling` или `task`).
- **Зависимости**: встроенные зависимости Gitea. Добавить блокирующую
  задачу:
  `tea api -X POST repos/ddmitry/dotfiles/issues/<дочерняя>/dependencies
  -d '{"owner":"ddmitry","repo":"dotfiles","index":<блокирующая>}'`.
  Посмотреть: `tea api repos/ddmitry/dotfiles/issues/<n>/dependencies`.
  Задача свободна от блокировок, когда все блокирующие задачи закрыты.
- **Свободные задачи**: открытые дочерние задачи карты без открытых
  блокирующих и без исполнителя; первой берётся та, что раньше в списке карты.
- **Взять задачу**: `tea issues edit <n> --add-assignees ddmitry` — первым
  действием сессии.
- **Завершить**: комментарий с ответом, `tea issues close <n>`, затем краткий
  итог со ссылкой в раздел «Принятые решения» описания карты.