From d29d3c0e9ba73711f54907396ed10e8d80febcf6 Mon Sep 17 00:00:00 2001 From: Cameron Cordes Date: Tue, 29 Sep 2026 20:43:20 -0400 Subject: [PATCH] docs(agents): labels must exist before tea can apply them MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The tracker doc said labels that don't exist are created on first use. They aren't: `tea issues create --labels` and `issues edit --add-labels` silently drop unknown names (the command succeeds, the issue stays unlabelled) — observed filing #151/#152 while the repo had no labels. Document creating them with `tea labels create` and checking the result. The five triage labels now exist on the server; the wayfinder:* family still has to be created before first use. Co-Authored-By: Claude Opus 5.5 --- docs/agents/issue-tracker.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md index 6a63ea0..f2c9db4 100644 --- a/docs/agents/issue-tracker.md +++ b/docs/agents/issue-tracker.md @@ -7,7 +7,8 @@ Issues and specs for this repo live as issues on Gitea - **Create an issue**: `tea issues create --title "..." --description-file -` (read the body from a heredoc on stdin), or `--description "..."` for a - one-liner. Add labels at creation with `--labels "..."`. + one-liner. Add labels at creation with `--labels "..."` (the labels + must already exist — see below). - **Read an issue**: `tea issues --comments`. Use `tea issues list -f index,title,body,labels,comments -o json` for machine-readable output. @@ -16,8 +17,16 @@ Issues and specs for this repo live as issues on Gitea - **Comment on an issue**: `tea comments add "..."` (alias: `tea comments "..."`). - **Apply / remove labels**: `tea issues edit --add-labels "..."` / - `--remove-labels "..."`. Labels that don't exist yet are created by the - server on first use. + `--remove-labels "..."`. +- **Labels must exist first.** Neither `issues create --labels` nor + `issues edit --add-labels` creates a missing label: an unknown name is + **silently dropped** — the command succeeds and the issue ends up + unlabelled (verified against this server, tea 0.16). Check with + `tea labels list`; create with + `tea labels create --name "..." --color "#rrggbb" --description "..."`, + then apply. After labelling, confirm it stuck (`tea issues `). + The triage labels (`triage-labels.md`) exist; the `wayfinder:*` labels + below must be created before first use. - **Close**: `tea issues close `. It does not accept a closing comment, so post the explanation first with `tea comments add "..."`, then close.