# Issue tracker: Gitea

Issues and specs for this repo live as Gitea issues on `git.arthurerlich.de` (repo `haylan/tpf3-overtake`). Use the `tea` CLI for all operations (see the `gitea-tea` skill).

## Conventions

- **Create an issue**: `tea issues create --title "..." --description "..."`. Use a heredoc for multi-line bodies.
- **Read an issue**: `tea issues <number> --comments`
- **List issues**: `tea issues list --state open --fields index,title,body,labels` with `--labels` filters as needed.
- **Comment on an issue**: `tea comment <number> "..."`
- **Apply / remove labels**: `tea issues edit <number> --add-labels "..."` / `--remove-labels "..."`
- **Close**: `tea issues close <number>` (comment first with `tea comment`)

Infer the repo from `git remote -v` — `tea` does this inside a clone.

## Pull requests as a triage surface

**PRs as a request surface: no.**

## When a skill says "publish to the issue tracker"

Create a Gitea issue.

## When a skill says "fetch the relevant ticket"

Run `tea issues <number> --comments`.

## Wayfinding operations

Used by `/wayfinder`. The **map** is a single issue labelled `wayfinder:map`; **child** tickets are issues labelled `wayfinder:<type>` (`research`/`prototype`/`grilling`/`task`) with `Part of #<map>` at the top of the body and listed in the map's task list.

- **Blocking**: a `Blocked by: #<n>, #<n>` line at the top of the child body. Unblocked when every blocker is closed.
- **Frontier query**: open children of the map, minus any with an open blocker or an assignee; first in map order wins.
- **Claim**: assign the issue to yourself (`tea issues edit <n> --add-assignees <user>`).
- **Resolve**: comment the answer, close the issue, then append a pointer to the map's Decisions-so-far.