feat: implement metadata catalog database management

docs/agents/issue-tracker.md

@@ -0,0 +1,28 @@
+# Issue tracker: Gitea
+
+Issues and specs for this repository live in the self-hosted Gitea repository:
+`https://git.tylconsulting.it/mptyl/ThothII`.
+
+## Conventions
+
+- **Create an issue**: use the repository's Gitea web UI, or the Gitea REST API when an
+  authenticated token with issue scope is available.
+- **Read and list issues**: use the Gitea web UI or authenticated API; include labels and comments.
+- **Apply or remove labels**: use the issue's label controls or the Gitea API.
+- **Comment and close**: use the issue page or the Gitea API.
+- Do not use `gh issue ...` for this repository: the `github` remote is a mirror, not the canonical
+  issue tracker.
+
+## Repository identity
+
+- Canonical Git remote: `origin` → `https://git.tylconsulting.it/mptyl/ThothII.git`
+- GitHub mirror: `github` → `https://github.com/mptyl/ThothII.git`
+- Canonical issue URL: `https://git.tylconsulting.it/mptyl/ThothII/issues`
+
+## When a skill says “publish to the issue tracker”
+
+Create an issue in the canonical Gitea repository.
+
+## When a skill says “fetch the relevant ticket”
+
+Read the referenced issue in the canonical Gitea repository.