sofarr/.agents/rules/tea-interaction.md

trigger, description

trigger	description
model_decision	The workspace contains a configured and pre-authenticated Gitea CLI (`tea`) tool that you must use to manage issue tickets, pull requests, and repository metadata.

# Gitea CLI (tea) Integration Guidelines

The repository is connected to a private Gitea instance. The workspace contains a configured and pre-authenticated Gitea CLI (`tea`) tool that you must use to manage issue tickets, pull requests, and repository metadata.

## 1. CLI Location & Login Context
- **Binary Path**: `/usr/local/bin/tea`
- **Gitea Base URL**: `https://git.i3omb.com`
- **Username**: `Gandalf`
- **Active Authenticated Login**: `sofarr` (Pre-configured with scopes `write:user,write:issue`)
- **Target Repository Slug**: `Gandalf/sofarr`

## 2. Mandatory Non-Interactive Usage Rules
The CLI commands must be run non-interactively to avoid blocking terminal processes or prompting for user inputs.
- Always explicitly pass the `--login sofarr` (or `-l sofarr`) flag.
- Always explicitly pass the `--repo Gandalf/sofarr` (or `-r Gandalf/sofarr`) flag.

## 3. Common Operations Reference

### Listing Issues
```bash
/usr/local/bin/tea issues list --login sofarr --repo Gandalf/sofarr --state all

Creating an Issue with Labels

/usr/local/bin/tea issues create \
  --login sofarr \
  --repo Gandalf/sofarr \
  --title "BUG: [Brief Title]" \
  --description "[Detailed description of the issue, reproducing steps, and context]" \
  --labels "Kind/Bug"

Adding/Editing Labels on an Existing Issue

To add labels without removing existing ones:

/usr/local/bin/tea issues edit \
  --login sofarr \
  --repo Gandalf/sofarr \
  --add-labels "Kind/Bug,Priority/High" \
  <issue_index>

To remove labels:

/usr/local/bin/tea issues edit \
  --login sofarr \
  --repo Gandalf/sofarr \
  --remove-labels "Priority/Low" \
  <issue_index>

Commenting on an Issue/PR

/usr/local/bin/tea comment \
  --login sofarr \
  --repo Gandalf/sofarr \
  <issue_index> "[Resolution or update details]"

Closing an Issue

/usr/local/bin/tea issues close \
  --login sofarr \
  --repo Gandalf/sofarr \
  <issue_index>

Reopening an Issue

/usr/local/bin/tea issues reopen \
  --login sofarr \
  --repo Gandalf/sofarr \
  <issue_index>

4. Standard Labels Reference

Always use one or more of the following pre-configured labels when creating or updating issues:

Type	Label Name	Description
Kinds	Kind/Bug	Something is not working
	Kind/Feature	New functionality
	Kind/Enhancement	Improve existing functionality
	Kind/Documentation	Documentation changes
	Kind/Security	Security issues and patches
	Kind/Testing	Issue or PR related to testing
Priorities	Priority/Critical	Critical/blocking issue
	Priority/High	High priority
	Priority/Medium	Medium priority
	Priority/Low	Low priority
Compatibility	Compat/Breaking	Breaking change that won't be backward compatible
Review	Reviewed/Confirmed	Issue has been confirmed/verified
	Reviewed/Duplicate	Duplicate of another issue or PR
	Reviewed/Invalid	Invalid issue or question
	Reviewed/Won't Fix	Decision made not to address this issue
Status	Status/Blocked	Blocked by other dependencies/tasks
	Status/Abandoned	Work started but currently abandoned
	Status/Need More Info	Awaiting more feedback/information to proceed

5. Verification Check

To verify login configurations and connectivity without making modifications, use:

/usr/local/bin/tea logins list

To list all active labels in the repository:

/usr/local/bin/tea labels list --login sofarr --repo Gandalf/sofarr

***