docs: kaputtes Assign-Kommando im Tracker-Doc ersetzen

tea issues edit --add-assignees ruft POST /issues/<index>/assignees auf, den
Gitea nicht kennt - der Aufruf endet in einem nackten 404, ohne dass tea das
als Fehlbedienung kenntlich macht. Assignees werden stattdessen per PATCH auf
das Issue gesetzt.

Betrifft direkt den Claim-Schritt jeder Wayfinder-Session, deshalb an beiden
Stellen korrigiert.
This commit is contained in:
2026-08-27 14:42:17 +02:00
parent 6afea83cdd
commit c2ea1cc410

View File

@@ -24,7 +24,16 @@ when running from outside the clone.
- **Comment on an issue**: `tea comments add <index> --description "..."`. - **Comment on an issue**: `tea comments add <index> --description "..."`.
(The subcommand is `add`, not `create`.) (The subcommand is `add`, not `create`.)
- **Apply / remove labels**: `tea issues edit <index> --add-labels "a,b"` / `--remove-labels "a"`. - **Apply / remove labels**: `tea issues edit <index> --add-labels "a,b"` / `--remove-labels "a"`.
- **Assign**: `tea issues edit <index> --add-assignees RDietermann`. - **Assign**: **not** `tea issues edit --add-assignees` — that flag posts to
`POST /issues/<index>/assignees`, which Gitea does not have, and fails with a bare 404.
Assignees are set by patching the issue:
```bash
tea api --method PATCH "repos/RDietermann/dionotes-client/issues/<index>" \
-F assignees='["RDietermann"]'
```
This replaces the whole list, so include existing assignees when adding one.
- **Close**: `tea issues close <index>`. It takes no closing comment, so post the explanation - **Close**: `tea issues close <index>`. It takes no closing comment, so post the explanation
first with `tea comments add`, then close. first with `tea comments add`, then close.
- **Create a label** (they are not auto-created): `tea labels create --name "..." --color "#rrggbb"`. - **Create a label** (they are not auto-created): `tea labels create --name "..." --color "#rrggbb"`.
@@ -79,7 +88,7 @@ Used by `/wayfinder`. The **map** is a single issue with **child** issues as tic
- **Frontier query**: `tea issues ls --output json --labels wayfinder:grilling,wayfinder:research,wayfinder:prototype,wayfinder:task`, - **Frontier query**: `tea issues ls --output json --labels wayfinder:grilling,wayfinder:research,wayfinder:prototype,wayfinder:task`,
keep those whose body says `Part of #<map>`, drop any with an assignee (claimed) or an open keep those whose body says `Part of #<map>`, drop any with an assignee (claimed) or an open
blocker; first in map order wins. blocker; first in map order wins.
- **Claim**: `tea issues edit <index> --add-assignees RDietermann` — the session's first write. - **Claim**: assign the ticket via the PATCH call under "Assign" above — the session's first write.
- **Resolve**: `tea comments add <index> --description "<answer>"`, then - **Resolve**: `tea comments add <index> --description "<answer>"`, then
`tea issues close <index>`, then append a context pointer (gist + link) to the map's `tea issues close <index>`, then append a context pointer (gist + link) to the map's
Decisions-so-far. Decisions-so-far.