Genarrative/docs/agents/issue-tracker.md

Issue tracker: Gitea

Issues and PRDs for this repo live as issues in the self-hosted Gitea remote:

• Remote: https://git.genarrative.world/GenarrativeAI/Genarrative.git
• Tracker type: Gitea Issues

Conventions

• Prefer the Gitea tea CLI when it is installed and configured for this host.
• Do not use GitHub gh or GitLab glab for this repo unless the repository is explicitly migrated to those platforms.
• If tea is unavailable, use the Gitea Web UI or Gitea REST API for the same operations.

Common operations with tea

Exact flags can vary by tea version. Run tea issues --help or tea issue --help before using a command in a new environment.

• Create an issue: tea issues create --title "..." --body "..."
• Read an issue: tea issues view <number>
• List issues: tea issues list
• Comment on an issue: use the installed tea issue comment command shown by tea issues --help; if unavailable, use the Gitea Web UI or REST API.
• Apply labels: use the installed tea issue update/edit command shown by tea issues --help; if unavailable, use the Gitea Web UI or REST API.
• Close an issue: use the installed tea issue close/update command shown by tea issues --help; if unavailable, use the Gitea Web UI or REST API.

When a skill says "publish to the issue tracker"

Create a Gitea issue in GenarrativeAI/Genarrative with the requested title, body, labels, and links back to any relevant docs or branch.

When a skill says "fetch the relevant ticket"

Read the Gitea issue body and comments/notes for the referenced issue number. Include labels and current open/closed state in the working context.

Authentication

Use the locally configured Gitea credentials for the current developer. Do not commit tokens, cookies, .env, or local credential files.