docs: Gitea-Dependency-Aufruf nach Verifikation korrigieren

Der Endpoint war als ungeprueft markiert. Beim Verdrahten der ersten
Wayfinder-Map hat sich gezeigt: owner und repo muessen im Body wiederholt
werden, der Pfad allein reicht nicht. Ohne sie schlaegt der Aufruf mit
"repository does not exist [owner_name: ]" fehl, was in eine falsche Richtung
zeigt. Die von tea dokumentierten {owner}/{repo}-Platzhalter werden hier
ebenfalls nicht ersetzt.
This commit is contained in:
2026-08-27 14:36:48 +02:00
parent 01e02b30b0
commit 6afea83cdd

View File

@@ -64,12 +64,18 @@ Used by `/wayfinder`. The **map** is a single issue with **child** issues as tic
Gitea 1.24+ has native sub-issues, but `tea` does not expose them — the `Part of #<map>`
line is the convention here, and Gitea renders it as a cross-reference on the map.
- **Blocking**: Gitea has **native issue dependencies**, which is what renders the frontier in
the web UI. `tea` does not wrap them, so use the API:
`tea api --method POST repos/RDietermann/dionotes-client/issues/<child>/dependencies -d '{"index": <blocker>}'`.
Read them back with `tea api repos/RDietermann/dionotes-client/issues/<child>/dependencies`.
**Unverified** — the first session to wire a blocking edge should confirm this endpoint
works and fix this line. If it does not, fall back to a `Blocked by: #<n>, #<n>` line at the
top of the description. A ticket is unblocked when every blocker is closed.
the web UI. `tea` does not wrap them, so use the API — **verified working**:
```bash
tea api "repos/RDietermann/dionotes-client/issues/<child>/dependencies" \
-F index=<blocker> -f owner=RDietermann -f repo=dionotes-client
```
The body must repeat `owner` and `repo` — the path alone is not enough, and omitting them
fails with a misleading `repository does not exist [owner_name: ]`. The `{owner}`/`{repo}`
placeholders `tea api` documents do **not** get substituted here either; write them out.
Read the blockers back with a plain GET on the same path. A ticket is unblocked when every
blocker is closed.
- **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
blocker; first in map order wins.